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PREFACE 


GIMMS is a general purpose geo-cartographic information system, widely used by 
commercial, central/local government and academic institutions for the presentation 
and analysis of geographic data. 


Since the previous edition of the GIMMS Reference Manual in 1983, the package has 
undergone substantial development. Major additions include, contour mapping, 
macro libraries and on-screen menu facilities. 


This edition of the Manual incorporates many example command runs, illustrating the 
extensive design and data manipulation facilities offered by the system. 
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THE GIMMS MAPPING PACKAGE 


GIMMS ts a general purpose geoprocessing system, widely used in the analysis and 
display of spatially referenced data. Graphical output takes the form of maps, business 
graphs and diagrams and extensive data manipulation procedures are available. 


DESIGN FACILITIES 


GIMMS tncorporates an extensive range of cartographic design facilities to generate 
high quality maps, business graphs, and diagrams. 


A variety of map types are available, including area, point, dot, label and contour and 
both single and multi-dimensional distributions can be displayed. In addition, maps 
may be produced at any scale or orientation and data can be subset to generate insets. 


GIMMS also generates linegraphs, bar charts, scattergram and pie charts and there are 
numerous options available to define and label axes and control general layout. It is 
also possible to combine maps and graphs together on the same page. 


Due to extensive text manipulation facilities, GIMMS is also used to design diagrams 
and overhead transparencies for presentation and teaching purposes. 


COMMAND STRUCTURE 


GIMMS is divided tnto a series of Application Modules, each of which is driven by a 
series of keyword commands and subsidiary options or parameters. Input is relatively 
free-format and constraints are not imposed by the need to place commands or data 
In specific lines or columns. Facilities also exist to generate and store macro command 
sequences and produce on-screen menus. 


OPERATIONAL MODES 


GIMMS will operate tn both batch or interactive mode. Some parts of the system are 
primarily suited to batch work, such as polygon creation; other parts, for example map 
compilation, are designed for the interactive environment. The mode of operation 
most frequently used will depend on local computing facilities. 


DATA INPUT 


Geographical or Locational data is input in three ways, depending on its 
characteristics; point locations are input as points, lines are input as lines in a 
network, and areas (or polygons) are input as boundary segments. Area data Is 
further verified during processing to ensure geographic completeness, correctness and 
consistency using a series of checking routines. 


INTERFACES TO OTHER PACKAGES 


Users with complex data analysis problem may require specialised manipulation 
facilities. GIMMS has therefore been successfully interfaced to a number of other 
packages such as SPSS and the ORACLE relational database system. 


FORMAT OF THIS REFERENCE MANUAL 


The GIMMS Reference Manual is divided into four main parts: 


Sections 2 and 3 outline how the system operates and commands available from the 
Main Control Program; 


Sections 4 and 5 discuss data input; 
Sections 6 and 7 describe the commands available to generate graphic output; 


Sections 8 and 9 describe the variety of data manipulation facilities included within 
the system. 


Examples of GIMMS command sequences are incorporated within the text and also in 
Appendix C. Output from these examples has been photographically reduced to 


comply with the format of this manual and this has obvious implications for 
measurements. 


RELATED PUBLICATIONS 


A number of publications are now available to supplement this manual and include; 


Introductory User Guide to GIMMS (1987) 
by A W Carruthers 


GIMMS Macro Guide (1988) 
by A W Carruthers 


System Library Guide (1988) 
A series of GIMMS Thematic Guides are also being prepared, these currently include: 


Guide to using the GIMMS Business Graphics Facilities (1988) 
by Craig Young 


Guide to using Ordnance Survey Digital Maps with the GIMMS Software (1988) 
by Jean Ward 


It is expected that this list will be added to on a regular basis. An up-to-date list of 
GIMMS Publications and prices can be obtained by contacting GIMMS Ltd or your 
distributor. 


N.B. A GIMMS Newsletter is produced on a six monthly basis, and contains a variety 
of articles from GIMMS sites, as well as up-to-date information on courses 


Lan 


available to GIMMS users. Two copies of this Newsletter are automatically sent 
to each GIMMS site. Any user wishing to be added to the Newsletter mailing list 
should contact GIMMS Ltd. 
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SECTION 2 : SYSTEM OPERATION 


CONTENTS 


DATA INPUT AND DATA OUTPUT 
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2.2.3.0 Command Documentation 


2.2.3.1 Parameter Characteristics 
2.2.3.2. Cursor Operations using GPIS 


2.0.0.0 DATA INPUT AND DATA OUTPUT 


GIMMS will process three types of data: 
Locational data - 
defining geographic frameworks in terms of points, lines, and polygons (areas). 
Non-locational data - 
represented by numeric and/or alpha-numeric data. 
Command input - 


controlling the system and its operations by means of a pre-defined command 
language. 


Non-locational data may be held in association with existing locational data sets, for 
example, for the purposes of mapping projects. Both data types however, are 
generally stored in GIMMS data banks from where they can be retrieved and 
manipulated by the user through command input. 

Locational and non-locational data input are described tn Section 4; command input ts 
discussed in this Section. 

GIMMS produces two forms of output: 

Printed output - 


consisting of diagnostic printing, listings, and error messages. The volume of 
printed output is determined by the user. 


Graphic output - 
generally in the form of maps, business graphs and diagrams. Graphic output 


can be directed to a graphics terminal or plotted by a graph plotter. The 
production of graphic output is discussed in Sections 6 and 7. 


2.1.0.0 APPLICATION MODULES 


The GIMMS package ts divided into a series of Application Modules. Each Application 
Module is designed to perform a different set of functions. For example, the *FILEIN 
module handles data input, while the *PLOTPROG module is used to produce 
thematic maps. 


Only a subset of the Application Modules available will be accessed by the user during 
a GIMMS command run. However, in the course of a large-scale project, most modules 
will be used, though at different times. 


A GIMMS project will generally consist of three phases: 
1. The creation of locational data bank(s) from digitised input; 
2. Thecreation of non-locational data bank(s): 


3. The production of maps, business graphs and diagrams using data extracted 
from previously created data banks 


Figure 2.1 illustrates major stages in a GIMMS mapping project. It is assumed that the 
locational data has been stored in the form of closed areas or polygons. The names of 
relevant GIMMS modules and commands are included in the diagram t.e. *FILEIN, 
*PLOTPROG, *GRAPHICS, *CHECK and *POLYGON. These commands are described in 
the appropriate sections in this Reference Manual. 


2.2.0.0 GENERAL NOTES ON DATA INPUT 


Data input, whether locational, non-locational or command, is generally free-format 
and spaces and newlines can be used liberally to separate data elements. 


GIMMS will only recognise data input between columns 1 to 80 inclusive. Data 
appearing beyond column 80 WILL BE IGNORED. As most computer terminals are only 
80 columns wide this is not necessarily a major handicap. Users must exercise care 
however, when using wide format input devices. 


Input which extends beyond column 80, perhaps because it is in the form of precoded 
survey data, can be read into GIMMS using FORMAT control statements (see Section 
4.3.2.1 under FORMAT). These may also be used to read fixed-format, non-locational 
data. 
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2.2.1.0 Command Input 


GIMMSS recognises four types of command input: 


a) 


b) 


c) 


d) 


Module and command names 

Module and command names are always preceded by an asterisk (*), for 
example, *FILEIN, *GRAPHICS, *NEWMAP, and *TEXT. In addition, modules are 
‘entered’ by the command '*module-name (e.g. *PLOTPROG) and ‘exited’ by the 
command *END. 

A useful command to issue after an Application Module has been entered is: 


=? 


This will print the list of currently available commands within that module. 


Sub-commands 


Some commands have sub-commands which may be selected by predefined 
keywordsi.e. reserved words. For example: 


*SYMBOLISM POINT 


This command string selects the POINT sub-command available within the 
command *SYMBOLISM. 


Parameters or options 


Most GIMMS commands are controlled by a variety of parameters or options. For 
example: 


*TEXT POSITION = 2,2 ...... 
where POSITION is a parameter within the command *TEXT. 
Some commands have no parameters, for example, *~PLOTPROG, which switches 
from the Main Control Program to the mapping module. The majority of 


commands, however, are accompanied by parameter data. The processing of 
parameter data is described in Section 2.2.2.0 (General Parameter Input). 


Other input 
Descriptions of other types of input are documented together with the 


appropriate commands. For example, within the command *FILEIN the 
processing of fixed-format data is discussed (see Section 4). 


2.2.2.0 General Parameter Input System (GPIS) 


The General Parameter Input System (GPIS) provides the user with the means to 
specify or alter GIMMS parameters. This method is general purpose and input can be 
either brief or verbose, as the user wishes. GPIS is suited to both batch and interactive 
work; when used interactively, it facilitates the use of the graphic cursor to specify 
data input (see Section 2.2.3.2). 


A description of how GPIS operates is presented below. Accompanying examples use 
the * TEXT command which is described in Section 6. 


A parameter or option may be selected by issuing a keyword followed by an 
appropriate value. For example: 


*TEXT XVALUE 2 YVALUE 2.0 SIZE 0.3 TEXT ‘Text string’ 


This command will plot the TEXT ‘Text string’ at the (KVALUE, YVALUE) position (2,2), 
measured in centimetres from the bottom left corner of the plotting window. The 
SIZE, or height of the characters will be 0.3 centimetres. 


XVALUE, YVALUE, SIZE, and TEXT are parameter keywords within the command 
*TEXT. The values 2, 2.0,0.3, and ‘Text string have been allocated by the user. 


Keywords and their associated values may be specified in any order. For example: 
*TEXT YVALUE 2 TEXT 'Textstring’ XVALUE 2.0 SIZE 0.3 
This command would have the same effect as the original. If a parameter is specified 


more than once in a command string, the last value is the one which ts accepted. 


Equal signs (=), commas (,) and/or spaces can be used as separators within command 
strings. For example: 


*TEXT XVALUE =2, YVALUE =2.0, SIZE =0.3 TEXT = Text string’ 


In practice, one or more spaces, newlines, commas, or equal signs are treated as single 
spaces. They may therefore be used liberally to improve the readability of command 
sequences. 


Most parameter keywords have ALIAS names. These may be used in place of the 
primary keyword. For example: 

*TEXT X 2 Y 2HT=0.3 TEXT ‘Text string 
This command would again have the same effect as the original because X Is an alias 


keyword for XVALUE, Y is an alias for YYVALUE and HT ts an alias for SIZE. 


The use of keywords is an explicit though verbose way of specifying parameter input. 
However, for the general user, it is to be highly recommended. 


Each set of command parameters is stored as an ordered list within GIMMS. Users may 
therefore omit parameter keywords from command input providing values are 
specified in the correct order. For example, in the command *TEXT, the first few 
keywords (and their aliases) are stored as follows: 


XVALUE or X or POSITION 
YVALUE or Y 

SIZE or HEIGHT or HT or S 
ANGLE 

TEXT 


Consequently the command string: 
*TEXT 2 2 0.3 0.0 ‘Text string’ 


would again have the same effect as the original command. A ‘pointer’ is used to 
identify which parameter is to be read. This pointer moves forward through the list 
one place each time a value is specified. When the *TEXT command is detected, the 
pointer is automatically positioned opposite the first parameter in the parameter list 
i.e. XVALUE. The first value in the user's *TEXT command string is read and allocated 
to this parameter. The pointer then moves forward through the parameter list to the 
next keyword, YVALUE. The second value in the user's *TEXT command string 1s read 
and allocated to this parameter. In the same manner, the value 0.3 Is allocated to the 
parameter SIZE; the value 0.0 is allocated to ANGLE; and the value ‘Text string’ is 
allocated to TEXT. 


The pointer may be explicitly located on the parameter list if a keyword name is 
included in a user's command string. For example: 


*TEXT HT 0.3 X 2 2 TEXT ‘Text string’ 


would again have the same effect as the original command. The text SIZE is explicitly 
defined by the alias keyword HT and the value is set to 0.3cm. The pointer has 
therefore moved forward in the list to the parameter ANGLE. If this had been 
followed by another numerical value it would have been interpreted as a value for 
ANGLE. However, the keyword X (alias for XVALUE) is next in the user's command 
String. Consequently, the pointer is moved backwards through the parameter list to 
XVALUE. The two values following are therefore interpreted as XVALUE and 
YVALUE respectively. 


WARNING: In general, the list of parameters given for each command in this 
Reference Manual is the order stored and recognised by GIMMS. But due 
to continous software development, this CANNOT BE GUARANTEED. The 
current order of parameters within a command however, may always be 
obtained using the GPIS Help Facility (see Section 2.2.2.3). 


The type of value specified may also move the pointer forward through the 
parameter list. Forexample: 

*TEXT ‘Text string’ 
When this command ts issued, the pointer is opposite the first parameter on the list I.e. 


XVALUE. In order that the above command be interpreted correctly however, the 
pointer should be opposite the parameter TEXT. Although it has not been moved 
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explicity by means of a keyword, GIMMS will automatically move the pointer through 
the list until a match is found for the parameter type (see Section 2.2.3.1 under 
Parameter Types). If the end of the list is reached and no match ts found, an error 
message will be printed and parameter reading for that command will be terminated. 


In all of the above examples it should be noted that the pointer moves forward 
from its current position in the parameter list. For example, the following command 
string would fail and produce an error message: 


*TEXT REALSIZE 2,2,0.3, ‘Text string 


After the keyword REALSIZE has been read, the pointer will move opposite the next 
keyword, ONX (see Section 2.2.2.3 for the complete list of parameters available within 
*TEXT). When the value 2 is read from the user's command string, GPIS will search 
forward through the list attempting to match with a parameter of type numeric. 
When this match fails the following error message will be issued: 


**** NO VALUE TO MATCH KEY GIVEN 


The command will then be aborted. However, any further commands will be 
processed as normal. 


The combination of implicit and explicit keywords can be used successfully to skip 
parameters. Forexample: 


*TEXT 2 2 0.3 ‘Text string’ 


will have the same effect as the original command. Note that the parameter 
ANGLE has been skipped. 


Some parameters have the ability to automatically return the pointer to the 
beginning of the parameter list. These are described in the documentation as having 
the parameter characteristic RETURN (see Section 2.2.3.1 under Special Actions). For 
example: 


*TEXT ‘Textstring 2 2 0.3 


would again have the same effect as the original command. On detecting the value 
‘Text string’, GIMMS will advance the pointer on the parameter list to TEXT. 
However, after reading the text string, the pointer will automatically return to the 
beginning of the parameter list. 


Some types of parameter (e.g. string) will not fail immediately on detecting the end 
of the parameter list. A further check will be made starting at the beginning of the 
list, to find a match (i.e. the pointer will be ‘wrapped round’). If still there is no match, 
an error message will be printed. 


Parameter input is terminated when a non-alphanumeric character is detected. The 
following characters however, are exceptions to this rule: 


= ?<@# 


i 5 


Commands may therefore be terminated by the * at the beginning of the next 
command. 


When GIMMS ts used interactively, a terminator should be deliberately included to 
force the execution of the command. For example: 


*TEXT Textstring, POSITION = 2,2,SIZE=0.3 * 


The terminating * would result in the immediate execution of this * TEXT command. 


The /symbol is a useful command separator. It will cause the command to be executed 
but control will remain inside that command. This results in the retention of some 
parameter values while others may be altered by the user. For example: 


*TEXT POSITION = 2,2 ‘Text 1° SIZE =0.3/ 
POSITION = 3,7 ‘Text 2’ * 


This command would plot two text strings at two different positions within the 


plotting window. Both text strings however, would have the same character SIZE i.e. 
0.3cm, as this value ts retained throughout the entire command sequence. 


2.2.2.1 Comments 


Comments may be included at almost any position in a GIMMS command run and must 
be enclosed by angled brackets < >. For example: 


*TEXT <text for legend > KEY =1 ‘BARLEY’/ 
KEY = 2 'WHEAT’/ < 1979 figures > 
KEY = 3 <nodata for 1978> ‘OATS'* 


N.B. Comments may contain any combination of characters except the > character 
which would automatically terminate the comment sequence. 


In addition to the < > comment form, the *COMMENT command may be used. It Is 
also terminated by the > symbol. 


There are several occasions when comments are NOT permitted: 
(a) inside text strings (see Appendix A) 


(b) in fixed-format data input (see Section 4) 


2.2.2.2 Super Commands 


There are several commands which may be issued at any point in a GIMMS command 
run. These are termed ‘super commands and include: 


DIAGS 
INPUT 
REINPUT 


These commands become operational as soon as they are issued by the user. For 
example: 


*TEXT INPUT 14 
would immediately switch GIMMS to read subsequent input from channel 14. 
The commands DIAGS and INPUT are discussed in detail in Section 3 (see the 
*SYSPARM command). The command REINPUT is used to switch to a different channel 
for input and to read from the beginning of the file allocated to that channel. 


2.2.2.3 The GPIS Help Facility 


If a command is followed by a question mark (?), a list of the associated keywords, 
their aliases (if any) and the type of parameter expected is printed. For example: 


*TEXT ? 
This command would produce the following help information: 


COMMAND: * TEXT 
PRINT OF OPTIONS 


XVALUE (POSITION) (X) /R,:P/ 
YVALUE (Y) /R,:P/ 
SIZE (HEIGHT) (HT) (S) /R,:D/ 
ANGLE (DEG) /R,:A/ 
TEXT /S/ 
KEEP (K) /K/ 
RESET (R) /K/ 
MAPUNITS /K/ 
RELX (RELATIVE) /R/ 
RELY /R/ 
RELSCALE /R/ 
TIMES(REPEAT) /\/ 
SHIFT /R/ 
BLOCK /K/ 
ALPHABET (FONT) (STYLE) /\/ 
TRATIO (RATIO) /R/ 
NLRATIO (NEWLINE) /R/ 
UNDERLIN (UNDER) /K/ 
CENTRE /K/ 
JUSTIFY /K/ 
CENTVAL (JUSTVAL) /R,:P/ 
ITALIC (SLANT) /R/ 
BOX /K/ 
XB1 /R,:P/ 
YB1 /R,:P/ 
XB2 /R,:P/ 
YB2 /R,:P/ 
MODRATIO (MR) /K/ 
MODSIZE (MS) (MH) /K/ 
KEYVAL (KEY) (LEGEND) (NEXT) (N) /\/ 
TOP /K/ 
SHIELD /R/ 


FRAME /R/ 


RIGHT /K/ 
VERTICAL /K,RETURN/ 
SHADE /K,RETURN/ 
PEN /\/ 
REALSIZE /K/ 
ONX /K/ 


The GPIS help facility is extremely useful when working interactively as an up-to-date 
list of parameters available within a particular command will be printed on the 
terminal screen. 


2.2.3.0 Command Documentation 


Commands are documented in terms of their associated parameters. These 
parameters are given in the order that implies their position in the parameter list (see 
Section 2.2.2.0). The most up-to-date parameter listing for a command may be 
obtained using the GPIS Help Facility (see Section 2.2.2.3). 


In GIMMS documentation, each parameter is described by: 


- its primary keyword, 

- existing alias names 

- its characteristics 

- abrief description of its function 


For example, one of the parameters in the *TEXT command Is SIZE. This parameter is 
documented as follows: 


SIZE (HEIGHT) (HT) (S) /R,:D,=0.5/ specifies height of text characters in centimetres 


The primary keyword is SIZE. This parameter has three alias keywords (HEIGHT), (HT), 
and (S). Any one of these alias names can be used tn a *TEXT command as an 
alternative to SIZE. The parameter characteristics are /R,:D, =0.5/ which means that 
any value allocated by the user should be a real number (R). In addition, this value may 
be set by the graphic cursor (:) as a distance (D). The default value for SIZE is 0.5cm 
(=0.5). In this Reference Manual the description is concluded by a brief note on the 
function of the parameter. 


2.2.3.1 Parameter Characteristics 


In the documentation, parameter characteristics are enclosed by slashes (/) and 
separated by commas. Each parameter may have up to four distinct characteristics: 


Type - 


to describe the type of value that can be allocated to the parameter by the user 
e.g. | (integer), R (real), S (string) 
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(a) 


Graphic cursor action - 


stating whether values can be allocated using the graphic cursor as points (:P), 
distances (:D), or angles (:A) 


Default value(s) - 


to be used if the user does not explicitly allocate a value to the parameter froma 
command string 


Special actions - 
e.g. PERM, RETURN, RESET, REPEAT, SPECIAL 


N.B. A parameter may have more than one special action. 


Parameter Types 
| - integer number 


The value allocated must be a signed or unsigned integral or whole number. (e.g. 
172, -342, 7) 


R - real number 


The value allocated must be a signed or unsigned number which may have a 
fractional part (e.g. 1.23, 9, -0.54, 123, 15762.147, .3). 


N.B. An integer value is acceptable as a real value and a value such as .3 is 
interpreted as 0.3 


S - string 


The value allocated must be a string of text characters enclosed by single primes 
(e.g. ‘Example of a TEXT string + -.88' ). 


K - keyword 


In this case there are no parameter values other than the presence or absence of 
the keyword alone. 


L - label 


The value allocated must be an alphanumeric string beginning with a letter, and 
comprising a maximum of 8 characters (e.g. FRED, A57) 


RV - real vector 
Values allocated must be a sequence of real numbers. For example, in the 
command *GRAPH the parameter DATA is described as a real vector. Input to this 


parameter therefore may be as follows: 


*GRAPH DATA = 23, 45, 56.23, 49.8, 73, 94, 88.2, 71 
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b) 


c) 


N.B. Values may be separated by spaces or commas. The list will be terminated 
by the occurrence of another parameter or keyword. 


E - expression 


The value allocated must be an arithmetic expression enclosed by brackets, e.g 
(POP/AREA). 


T - terminator 


A terminator with some other significance. For example, a slash (/) character 
frequently executes a command but control remains within that command. 


Graphic Cursor Actions 


-P —- value may be set by the graphic cursor as a single point, expressed as an X, 
Y value. 


‘D - value may be set by the graphic cursor as two points, using the C-continue 
code (see Section 2.2.3.2). The value is defined as the distance between the 
two points. 


‘A - value may be set by the graphic cursor as two points, using the C-continue 
code (see Section 2.2.3.2). The value is the angle subtended by a line 
joining two points, measured in degrees anti-clockwise from the positive 
direction of the X-axis. 


N.B. The graphic cursor can only be used to allocate values to selected 
parameters. If this facility is available it will be defined in the parameter 
characteristics list. 


Default Values 


The allocation of default parameters depends on the parameter type. Default 
values may be integer or real numbers, strings, labels, or, if the parameter type is 
keyword, the value ON or OFF. 


Defaults settings are included in the parameter characteristics list and indicated 
by the equals sign (=) followed by a value. Typical setting for the different 
parameter types are as follows: 


Parameter Types Default Values 
LR = number (eg. =5, =0.27) 
S = string (e.g. = NONE’) 
K = ON (i.e. default is that key word is issued) 
L = label (e.g. =AREA) 


Default values for parameter types RV and E cannot be preset. 
In some cases, the default setting for one parameter may depend on the value of 


another. In the documentation this is denoted by K:name where ‘name its the 
keyword of the second parameter. For example: 


222 


NMAPY /R, = K:NMAPX/ 
means that the parameter NMAPY will take the value of the parameter NMAPX 
if NMAPY is not explicitly specified by the user. 
Default settings may vary depending on conditions. If this is the case, conditions 
are enclosed by brackets. For example: 
= ON(BATCH) 


means that the default for a keyword is set to ON when GIMMS is operating in 
BATCH mode. Common conditions are: 


(BATCH) -—- when GIMMS is operating in batch mode 
(INTER) — when GIMMS Is operating in interactive mode 
(K:name) - only when the named keyword has been specified. 


These conditions may appear as follows: 
/L, = ALL(BATCH), = OUT(INTER)/ 


means that the default Label is ALL when GIMMS is operating in BATCH mode 
and OUT when GIMMS is operating INTERactively. 


If the default form is outside the control of the command being described and is 
dependent the value of another command, the C:name reference is used. For 
example: 


FILE /l, = (C: GIMMSFILE)/ 


means that the default for parameter FILE is set by the value allocated to a 
preceding GIMMSFILE command. Documentation for the GIMMSFILE command 
should also be investigated. 


If the default is different from anything specified, the =SPECIAL default is used. 
The documentation must be read to identify what default value is being used. 


If no default value(s) occur in the parameter characteristics list, the following 
values should be assumed for the different parameter types: 


Parameter Types Default Values 
[.R 0 (or 0.0) 
S blank string 
K no parameter, but default ts OFF 
(i.e. keyword not issued) 
E blank label 
RV no values 
E blank expression 
T no parameter, no default 
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d) Special Actions 


PERM —- indicates that the value allocated to a parameter with this 
special action will remain in force until the command is issued 
again. The value allocated may therefore be used by 
subsequent commands. Parameters without this special action 
only retain values for the duration of the present command. 


RETURN - indicates that when the parameter has been read, the pointer 
is automatically returned to the first element in the parameter 
list. 

RESET - indicates that parameter values will be automatically reset to 


the defaults when the next terminator is read. If this is the only 
parameter given before the terminator, it is the only action 


taken. 

REPEAT =n - indicates that more than one value may be read by this 
command and a maximum of n values may be input. For 
example: 


XLABELS /L,REPEAT = 20/ 
would allow a parameter list of 
XLABELS =JAN,FEB,MAR.... 
providing no more than 20 labels were specified by the user. 
SPECIAL - indicates that special action will be taken on specifying this 

keyword. 
2.2.3.2 Cursor Operations using GPIS 
Many command parameters in the *COMPILE module can be specified using the 
graphic cursor (see Section 6). This mechanism its activated by typing a command or 
parameter name followed by acolon (:) and keyboard return. For example: 


*TEXT: 


Some parameter values are defined by a single point, others may need two or more. 
Only the required number of points will be read regardless of how many are entered. 


Graphic cursor input 1s terminated by typing the keyboard character A or pressing the 
space bar. 


N.B. Graphic cursor input is only available on graphic terminals. 


There are four types of graphic cursor settings: 
1. Single point - If the parameter requires a single point then the X and Y 


values for the first coordinate identified by the graphic 
cursor is used. 
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2. Distance (2 points) — |f the parameter requires a distance value then the distance 
between the first two points identified by the graphic cursor 
iS used. 


3. Angle(2points)-  \f the parameter requires an angle value then the angle 
subtended by the line joining the first two points identified 
by the graphic cursor is used. This angle is measured in 
degrees, anti-clockwise from the positive direction of the 
X-axis. 


4. Sequence of points-—If the parameter requires a sequence of points then all 
points identified by the graphic cursor are used. 


Each time the cursor is positioned on the graphics screen the point is recorded by 
pressing any character on the keyboard. If the character is the letter C then it 
indicates that another point will be entered. If the character is either an A or the 
space bar then graphic cursor mode Is terminated. 


N.B. On some graphics terminals/installations it may be necessary to add a new line 
(LF or CR) after each character is typed to indicate the cursor position. 


If the letter A is used to terminate graphic cursor input then all possible parameters for 
that command will be automatically set. It is therefore possible to specify values for a 
number of parameters by indicating only two points. For example, the *NORTHPT 
command has four parameters which may be set by the graphic cursor. These are 
XVALUE, YVALUE, SIZE and ANGLE. 


Two points may be identified by the graphic cursor, one to indicate the start point of 
the north arrow and one to indicate the apex. If input is then terminated by typing the 
letter A instead of using the space bar, parameters XVALUE and YVALUE are set by 
the coordinates of the first point; SIZE is set to the distance between the first and 
second points; and ANGLE ts set by the line joining the two points. 


If graphic cursor mode Is initiated by typing a colon (:) and no parameters in the list 
can be set using this mechanism, an error message will be printed. 
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3.0.0.0 MAIN CONTROL PROGRAM 


When GIMMS is accessed by the user, the Main Control Program is automatically 
entered. This is the first level of the program and the commands available within it 
control access to the various Application Modules and subsystems. These commands 
are described below. 


3.1.0.0 CHANNELS FOR INPUT AND OUTPUT 


Command input to GIMMS ts generally read from Fortran logical channel 5 and text is 
output to logical channel 6. Graphic output is usually directed to channel 19. Channel 
numbers are however, dependent on local installation procedures and consequently 
may vary. Users should consult their local computer advisor. 


3.2.0.0 COMMAND INPUT TO THE MAIN CONTROL PROGRAM 


The Main Control Program is primarily designed to allow users to access and move 
between GIMMS Application Modules. The commands available within the Main 
Control Program may be specified in any order. If graphic output is required however, 
a graphic device must be referenced, using the *PLOTPARM command, prior to 
accessing any of the plotting modules (i.e. *PLOTPROG, *COMPILE and *GRAPHICS). A 
GIMMS command run is terminated by *STOP. 


The commands required to produce a map will generally be issued in the following 
order: 


*FILEPARM <to identify GIMMS data files and direct 
graphic output> 


*PLOTPARM DEVICE =PLOTTER <to select a graphic output device, such as a 
pen PLOTTER> 


*PLOTPROG <to access the mapping module > 


<selection of commands from the *PLOTPROG module > 


*END <to exit from the *PLOTPROG module and 
return to the Main Control Program > 


*STOP <to terminate the GIMMS command run > 


3.3.0.0 COMMANDS AVAILABLE FROM THE MAIN CONTROL PROGRAM 


Commands available from the Main Control Program are divided into three groups: 


1. System commands 


*SYSPARM 
*FILEPARM 
*PLOTPARM 
*TEXTPARM 
*STOP 


to modify system parameters 

to identify channels for input and output 
to modify orselect plotting parameters 
to modify or select text parameters 

to terminate a GIMMS command run 


2. Commands to access application modules and subsystems 


*FILEIN 
*PLOTPROG 


*COMPILE 
*GRAPHICS 


*MANIPULATE 
*UTILITIES 


*CHECK 


*POLYGON 


to access the data input Application Module (see Section 4) 
to access the thematic mapping Application Module (see 
Section 6) 

to access the interactive map compilation module (see 
Section 6) 

to access the Application Module producing business 
graphs (see Section 7) 

to access the data manipulation module (see Section 8) 

to access the module performing utility functions (see 
Section 9) 

to access the subsystem which topologically checks 
segment files prior to polygon creation (see Section 5) 

to access the subsystem which creates polygon (area) files 
from segment files (see Section 5) 


Each Application Module is controlled and directed by means of a unique set of 
sub-commands. After a module has been accessed from the Main Control 
Program, a list of the commands available can be obtained by issuing the 


command: 


+2 


To exit from the Application Modules *PLOTPROG, *COMPILE, *GRAPHICS, 
*MANIPULATE and * UTILITIES, the command *END ts required. This will return control 
to the Main Control Program from where the GIMMS command run may be 


terminated by *STOP. 


3. Miscellaneous Commands 


Data storage commands: 


*CALL 
*SAVE 
*RESTORE 
*FILEINFO 


to access a GIMMS macro 

to save non-locational data in GIMMS data files 

to restore non-locational data from GIMMS data files 

to provide descriptive information about GIMMS data files 


Drawing commands: 


*DRAWMAP 


*TEXT 


to plot GIMMS locational data files 
to add text to GIMMS locational data files after they are 
plotted using the command *DRAWMAP 


Other commands: 


*BOXING 


to access a GIMMS interactive game for up to four players 


3.3.1.0 System Commands 


System commands are used to define the general environment from which the various 
Application Modules and subsystems can be accessed. For example, system commands 
can be used to control the volume of printed diagnostics or to direct graphic output to 
appropriate devices. 


3.3.1.1 *SYSPARM Command 


This command ts used to modify a number of system parameters. 


Within the *SYSPARM command the following parameters are available: 


DIAGS 
INPUT 
OUTPUT 
ON 

OFF 
REWIND 
INITDA 
DAPRINT 
BATCH 
INTERACT 
LINKS 
NOLOGO 
LOGO 


TERMINAL 
USERLIB 
SYSLIB 
MODE 


PROMPT 


NONE 
BRIEF 
VERBOSE 


/\, = 1,PERM/ 
/\,=5,PERM/ 
/\, =6,PERM/ 
/K/ 

/K/ 

/\/ 

/\/ 

/K/ 

/K/ 

/K/ 

/\/ 

/K/ 

/L, = ON/ 


/L,PERM/ 

/K, =ON,PERM/ 
/K/ 

/K/ 

/K, =ON,PERM/ 
/K/ 

/K/ 

/K/ 


/K/ 
/K/ 
/K, =ON,PERM/ 


selects diagnostic level (0-4) 

selects new input channel for commands 
selects new output channel for text 

sets DIAGS = 1 

sets DIAGS =0 

rewinds a file to the beginning 

initialises a direct access file 

print information about the direct access system 
switches on BATCH mode 

switches on INTERACTive mode 

specifies a maximum number of segments 
switches off GIMMS logo 

switches GIMMS logo ON (default setting) or 
OFF 

selects terminal type 

selects search of User Macro Library 

selects search of System Macro Library 
selects mode for command entry 

selects command mode (default setting) 
selects conversational mode 

selects full menu mode 

selects amount of information displayed in 
menu mode 

switches off menu output 

selects brief menu form 

selects verbose menu form 


N.B. Although *SYSPARM is available from the Main Control Program, it may also be 
issued directly from within GIMMS Application Modules. 


Further Notes on *SYSPARM Parameters 

DIAGS, ON, OFF 
These parameters control the level of diagnostic information produced when 
certain commands are used. Some parts of GIMMS, especially commands relating 
to locational data management, have the capacity to provide different levels of 
diagnostics. 
The volume of diagnostic information produced can vary on a scale from 0 to 4. 
Level 0 (i.e. *SYSPARM DIAGS = 0) results in) no diagnostic information being 
produced, while level 4 (i.e. *SYSPARM DIAGS = 4) supplies detailed diagnostics. 
The default setting is level 1 (i.e. *SYSPARM DIAGS = 1). 


The keyword ON may be used as an alternative to DIAGS (i.e. *SYSPARM ON). 
This will automatically set the diagnostic level to 1. The commands *SYSPARM 
DIAGS = 1, *SYSPARM ON and *SYSPARM DIAGS = ON are therefore equivalent. 
The keyword OFF will automatically set the diagnostic level to 0 (i.e. *SYSPARM 
OFF). 

INPUT 


This parameter identifies a channel for subsequent GIMMS command input. For 
example: 


*SYSPARM INPUT 14 * 
will cause subsequent command input to be read from channel 14. 
The parameter INPUT may only be used to reference character files comprising a 
series of GIMMS commands. The value specified by INPUT represents a FORTRAN 
logical channel number. This channel should have been previously assigned by 
the user using the command *FILEPARM (see Section 3.3.1.2). 


N.B. The command *SYSPARM INPUT should be terminated by an asterisk (*). 


OUTPUT 


This paramater operates in a similar way to INPUT but instead directs text to an 
output channel. For example: 


*SYSPARM OUTPUT 12 * 
will direct output from subsequent GIMMS commands to a file referenced on 


FORTRAN logical channel 12. This channel number should have been previously 
assigned by the user using the command *FILEPARM (see Section 3.3.1.2). 


N.B. The command *SYSPARM OUTPUT should be terminated by an asterisk (*). 


REWIND, INITDA 


These parameters are included for compatibility with previous GIMMS releases. 


DAPRINT 


This parameter can be selected to print information about the file access buffer 
area and is reserved for system diagnostics. 


BATCH, INTERACT 


These parameters can be used to explicity set the mode of operation. The 
default mode is BATCH (i.e. *SYSPARM BATCH). When working interactively 
however, it may be advantageous to specify INTERACT (i.e. *SYSPARM 
INTERACT) as this facilitates better fault trapping and recovery options. 


LINKS 
This parameter can be used to alter the value for the maximum number of 
segments defining a polygon. It may be issued in response to one of the 
following error messages: 
*****NOT ENOUGH SPACE 
***** OVERFLOW ON LINKS = .... 
mE LONE cen HAS TOO MANY SEGMENTS = .... 
The format of the command is: 
*SYSPARM LINKS = n 

where n is greater than the value for the maximum number of segments. 

N.B. The parameter LINKS affects space allocation throughout the System. In 
some machine/installation sites care should be exercised when declaring 
the number of links as this will reduce the space available to process other 
data. 

USERLIB, SYSLIB 

When the *CALL command Is used to access a GIMMS macro and a User Macro 

Library is attached, it will be searched for an entry prior to seaching the System 

Macro Library. Parameters USERLIB and SYSLIB however, can be used to change 


the order of searching. For example, by issuing the command: 


*SYSPARM SYSLIB 


before *CALLing a macro, the System Library will be searched first. The default 
order can be re-instated at any time by issuing the command: 


*SYSPARM USERLIB 
The GIMMS Macro facility is fully described in ‘The GIMMS Macro Guide’ 
(Carruthers, 1988), published by GIMMS Ltd., Edinburgh. 
MODE, COMMAND, STEP, MENU 


These parameters allow users to define the way in which GIMMS accepts 
command input. Three modes are available: 


Command Mode - 
This mode may be selected by the command: 
*SYSPARM MODE = COMMAND * 
N.B. Command mode is the default setting. 
Conversational Mode - 
If this mode is selected, GIMMS will prompt users for values by stepping through 
a list of the parameters available within acommand. This mode ts selected by the 
command: 


*SYSPARM MODE = STEP * 


N.B. Prompts will only appear for the most popular parameters available within 
a command. 


Menu Mode- 


With a suitably configured terminal (see Section 9 under *TERMINAL Commana), 
GIMMS will support full on-screen menus. This facility allows users to select 
parameters by moving a screen cursor and input values using the normal 
keyboard. This mode ts selected by the command: 


*SYSPARM MODE = MENU* 


N.B. As with conversational mode, only a selection of the parameters available 
within a command will be displayed. However, when selected and used 
with GIMMS macros, more extensive menus can be generated (see Section 9 
under *~MACRO Command). 


PROMPT, NONE, BRIEF, VERBOSE 


These parameters determine the volume of output generated by conversational 
and menu modes. The most extensive form of menu Is selected by the command: 


*SYSPARM MODE =MENU PROMPT = VERBOSE * 


A more restricted or terse form of menu is generated by the command: 


*SYSPARM MODE = MENU PROMPT =BRIEF * 


TERMINAL 


This parameter defines the type of terminal being used and is required when 
menu mode is selected. For example, if the terminal type is VT 100, the following 


command would be issued: 


*SYSPARM TERMINAL = VT 100* 


N.B. The terminal type selected must have been previously configured using the 
command *TERMINAL (see Section 9 under *TERMINAL Commanda). 


3.3.1.2 *FILEPARM Command 


This command is used to reference channels and identify files for input and output. 


Within the *FILEPARM command the following parameters are available: 


CHANNEL (CHAN) (NO) (NUM) /\/ 
FILENAME (NAME) /S/ 
GIMMS (BINARY) (USER) (NONTEXT) /K, = default/ 
TEXT (CHAR) /K/ 
IN (INPUT) (OLD) /K/ 
OUT (OUTPUT) (NEW) /K/ 
OUTIN (INOUT) (UNKNOWM) /K, = default) 
CLOSE /K/ 
REWIND /K/ 
DATA (DATAFILE) /K/ 
GRID (GRIDFILE) /K/ 
MACRO (MACROFILE) /K/ 
SYSFILE /K/ 
ALPHABET /K/ 
FILESIZE(SIZE) /\/ 
INITSIZE (INIT) /\/ 
EXTENDSIZE(EXT) // 


specifies channel number 
specifes external file name 
identifies file as type GIMMS 
identifies file as type TEXT 
specifies file will only be used 
for input 

specifies file will only be used 
for output 

specifies file may be used for 
input and output 

closes a specified file 

rewinds a specified file 

selects a non-locational DATA 
file 

selects a GRID file 

selects a macro file 

selects a system file 

selects an alphabet file 

specifies the maximum size of a 
GIMMSS direct access file 
specifies the initial size of a 
GIMMS direct access file 
specifies the extend size of a 
GIMMS direct access file 


Further Notes on *FILEPARM Parameters 
CHANNEL 


This parameter specifies a FORTRAN logical channel number. Although channel 
numbers may vary depending on the machine/ installation site, they are often 
selected between 11 and 16. Users should consult their local computer advisor. 


FILENAME 


This parameter is used to specify the name of the file as it is referenced and 
stored on the computer. The format of the filename will depend on the 
conventions adopted by the operating system. Users should consult their local 
computer advisor. 


N.B. The file name must be enclosed by primes ("'). 


GIMMS, TEXT 


These parameters are used to specify the file type. If the file is a GIMMS system 
file e.g. POINT, SEGMENT, POLYGON, DATA, GRID or MACRO, the parameter 
GIMMS is applicable. If the file is a character file, such as a command file or 
output listing, the parameter TEXT is applicable. 


If this parameter is not explicitly specified in the *FILEPARM command, file type 
GIMMS is assumed. 


N.B. Some machine/installation sites recognise a third file type which will 
generally be used to denote plot files. Users should consult their local 
computer advisor. 


IN, OUT, OUTIN 


These parameters are used to define three types of file access. They are 
synonomous with the FORTRAN keywords OLD, NEW and UNKNOWN. 


IN denotes that a file already exists and will only be used for input; OUT denotes 
that a file will be created as a result of a current GIMMS command run and is only 
available to store output; OUTIN allows files to be updated during a GIMMS 
command run. 


Data files already existing may be referenced in the *FILEPARM command using 
the parameter IN (or OLD). For example: 


*FILEPARM CHANNEL =11 FILENAME = ‘Polygons’ GIMMS IN 
In thisexample input is read from the GIMMS file ‘Polygons’ on channel! 11. 
N.B. At some machine/ installation sites, the parameter IN is required to access 


files not specifically owned by the user; it may also be required to enable 
sharing of common files. 


When data files are first created they will be referenced in the *FILEPARM 
command using the parameter OUT (or NEW). For example: 


*FILEPARM 12 ‘Segments’ GIMMS OUT 


In this example, output is directed to channel 12 and a GIMMS file called 
‘Segments is created. 


N.B. In the above example the parameter keywords CHANNEL and FILENAME 


have been omitted and interpretation of the values relies on GPIS (see 
Section 2.2.2.0). 


OUTIN (or UNKNOWN) is generally used in conjuction with existing non- 
locational data files as they may be modified during the course of a GIMMS 
command run. For example: 

*FILEPARM DATA ‘Datafile’ GIMMS OUTIN 
In this example the reserved keyward, DATA, is used to reference a non- 
locational data file. This will automatically assign and read the data file from 
channel 21. 


N.B. OUTIN is the default setting. 


CLOSE 


This parameter can be used to close a specified file. The CHANNEL number must 
be supplied by the user. For example: 


*FILEPARM CHANNEL = 11 CLOSE 


will close the file previously opened on channel 11. 


REWIND 


This parameter will rewind a specified file to the beginning so its contents may 
be over-written or read again. For example: 


*FILEPARM CHANNEL = 13 REWIND 


will REWIND the file assigned to channel 13. 


DATA, GRID 


These parameters may be used to assign channels when non-locational and grid 
data files are being processed. For example: 


*FILEPARM DATA Datafile’ 


*FILEPARM GRID ‘Gridfile’ 


The parameter DATA will automatically assign the data file to channel 21, while 
the parameter GRID will assign the grid file to channel 22. 


N.B. |n the above examples values for file type and mode of access have been 
omitted. They will therefore be set to the default values GIMMS and 
OUTIN. 
The use of parameters DATA and GRID can significantly reduce processing time 
when large volume of data are involved as there will be no need to use the 
commands *SAVE or *RESTORE (see Sections 3.3.3.2 and 3.3.3.3). 
MACRO, ALPHABET, SYSFILE 


These parameters are used in the command *FILEPARM to attach User Macro 
Libraries, alphabet and system files. For example: 


*FILEPARM MACRO ‘Macrolib' 
*FILEPARM ALPHABET... 
*FILEPARM SYSFILE... 
User Macro Libraries are automatically assigned to channel 18, alphabet files to 
channel 9 and system files to channel 24. 
FILESIZE 


This parameter can be used to specify the maximum size of a GIMMS direct access 
file. 


N.B. This parameter is only required by some machine/ installation sites. 


INITSIZE 
This parameter can be used to specify the initial size of a GIMMS direct access file. 


N.B. This parameter is only required by some machine/ installation sites. 


EXTENDSIZE 


This parameter can be used to specify the size by which a GIMMS direct access file 
should be extended. 


N.B. This parameter is only required by some machine/ installation sites. 


Examples of *FILEPARM 
1. *FILEPARM CHANNEL = 11 FILENAME = ‘Polygons’ GIMMS OUTIN 


A file called ‘Polygons’ is assigned to channel 11. This file is of type GIMMS and 
the mode of access is OUTIN. 
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3.3.1. 


*FILEPARM 11, Polygons’ 

The parameter keywords CHANNEL and FILENAME have been omitted and 
interpretation of the values relies on GPIS (see Section 2.2.2.0). In addition, no 
values have been specified for the file type and mode of access and therefore the 
default settings GIMMS and OUTIN apply. 

*FILEPARM 12, ‘UKPOLY' GIMMS OUT 


A GIMMS file called 'UKPOLY’ will be created (OUT) on channel 12. 


*FILEPARM 19, 'Plotfile’ TEXT OUT 

A file called 'Plotfile’ will be created (OUT) on channel 19. This will be a TEXT or 
character file. 

*FILEPARM DATA ‘UKDATA' 


A non-locational DATA file called 'UKDATA' is referenced by this command. 
Default settings for file type and mode of access apply (i.e. GIMMS and OUTIN). 


*FILEPARM MACRO ‘Userlib’ 


A User Macro Library called ‘USERLIB’ is referenced by this command. Default 
settings for file type and mode of access apply (i.e. GIMMS and OUTIN). 


3 *PLOTPARM Command 


This command ts used to specify plotting parameters, the most important being the 
device type. 


Within the *PLOTPARM command the following parameters are available: 


FACTOR (F) (FACT) (SCALE) 


/R, = 1.0,PERM/ sets scaling factor 
MAPSIZE (NEWMAP) (PAGESIZE) (MAP) 
/R, = 30,PERM/ specifies size of default map used by 
*DRAWMAP 
YMAP /R, =K:MAPSIZE/ specifies Y dimension of map 
INCHES /K/ converts all values to inches 
SAVE /|,PERM/ specifies channel number to store inter- 
active graphic output 
BACK /1L,PERM/ specifies background colour for colour 
graphic terminals 
GENERAL /\/ selects generalisation level 
DEVICE /K/ identifies plotting device 
PLOTTER /K,PERM/ selects plotter output 
T4010 (T) (T4012) (T4013) 
/K,PERM/ selects Tektronix 4010 display 
T4014 /K,PERM/ selects Tektronix 4014 display 
T4662 /K,PERM/ selects Tektronix 4662 plotter 


T4027 /K,PERM/ selects Tektronix 4027 display 
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T4107 /K,PERM/ selects Tektronix 4105/ 4107/ 4205/ 4207 


display 

OTHER /K,PERM/ selects other plotting device 

XSIZE (X) /R,PERM/ specifies X dimension of OTHER device 

YSIZE (Y) /R,PERM/ specifies Y dimension of OTHER device 

NONE /K, = PERM/ switches off graphic output 

SHEET /R, =SPECIAL,PERM/ specifies limit of paper size 

PENWIDTH /R, =0.02,PERM/ specifies pen width 

BAUDS /\, = 1200,PERM/ sets terminal speed for Tektronix 40XX 
devices 

TITLE (TEXT) /S/ specifies title for jobstring (if required) or 
type of graphic device 

TRUSCALE /K,PERM/ switches off auto-scaling on _ graphic 
screens 

NOLOGO /K/ switches off GIMMS logo 

LOGO /K/ switches on GIMMS logo (default setting) 


Further Notes on *PLOTPARM Parameters 

FACTOR, INCHES 
The parameter FACTOR can be used in conjuction with a pen plotter to produce 
larger or smaller versions of a plot after it has been created at a specific size In 


effect, it modifies the overall scaling factor used for graphic output. 


A factor of greater than 1 will increase dimensions of the plotted output 
proportionally. For example: 


*PLOTPARM PLOTTER FACTOR =1.5 


will increase the overall size of a plot by a factor of 1.5. If the FACTOR specified Is 
less than 1, the dimensions of the plot will be reduced accordingly. 


By default, values are specified and processed in centimetres. If the parameter 
INCHES is selected however, values may be specified in inches. This is equivalent 
to setting the parameter FACTOR to 2.54. 

MAPSIZE, YMAP 
These parameters can be used to modify the default size of maps produced by 
the command *DRAWMAP (see Section 6). The default MAPSIZE is 30 by 30 
centimetres. 
N.B. The size of a map may also be altered from within the *DRAWMAP 

command (see Section 6). 

SAVE 
This parameter can be used to save a graphic image to a specified channel so it 
may be plotted again on a graphic terminal ata later date. For example, when 


a TEKTRONIX device is being used, the command: 


*PLOTPARM SAVE = 7 
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will save the TEKTRONIX codes to a file previously assigned by the user to 
channel 7 using the command *FILEPARM (see Section 3.3.1.2). 


N.B. This method of saving graphic images for later display is particularly 
efficient as GIMMS will not be required to reprocess the original data files. 


BACK 
This parameter specifies the background colour for colour devices such as the 
TEKTRONIX 4107. The selected background colour will be displayed after the 
*NEWMAP command has been issued (see Section 6). Colours available will 
depend on the device being used. 

GENERAL 
This parameter selects the generalisation level to be used when plotting GIMMS 
polygon files. 

DEVICE, PLOTTER, T4010, T4014, T4662, T4027, T4107 


These parameters can be used to specify the type of plotting device. For 
example: 


*PLOTPARM DEVICE =PLOTTER 

This command selects the local pen plotter and plotting package. 
When agraphic terminal is selected by a command such as: 

*PLOTPARM DEVICE =1T4107 
GIMMS uses internal information to scale graphic output to fit the terminal 
screen. The parameter FACTOR ts therefore automatically determined. 

OTHER, XSIZE, YSIZE 

These parameters can be used to specify the dimensions of a fixed screen device 
when it is different to those referred to above. If OTHER Is selected, values for 
the parameters XSIZE and YSIZE must be specified. For example: 

*PLOTPARM OTHER = 17,12 
describes a device with a screen display of 17 by 12 centimetres. 


Use of these parameters may vary depending on machine/ installation sites. 


NONE 


This parameter inhibits the generation of graphic output. 
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SHEET 


This parameter sets the maximum X dimension of paper used in a pen plotter. 
For example: 


*PLOTPARM SHEET = 200 

would set the X dimension to 200 centimetres. 

A GIMMS command run may be constructed to draw several maps, one after the 
other. Depending on the available plotter interface , sucessive maps will be 
drawn along the X dimension of the paper with each new plot being instigated 
by a *NEWMAP command (see Section 6). If dimensions set by a *NEWMAP 
command exceed those specified by parameter SHEET, a call is automatically 
made to *NEWSHEET. The effect of this will vary depending on the installation, 
but typically the computer operator will be prompted to insert a new piece of 
paper in the plotter. 


At installations where a continuous-roll plotter is in operation, there is 
theoretically no limit to the X-length of the paper. 
PENWIDTH 


This parameter can be used to specify the nib width of a plotting pen. The width 
will vary depending on the type of pen being used. For example, the command: 


*PLOTPARM PENWIDTH =0.05 


would specify the nib width as 0.05 centimetres (i.e. half a millimetre). The 
default value ts 0.02 centimetres. 


It isimportant to specify PENWIDTH when half tone shading Is being used. 
N.B. This parameter informs GIMMS of the width of the pen nib; it has no effect 
on the pen number. 
BAUDS 


This parameter is used to match the speed of output from the program to that of 
a terminal. 


Clearing the screen in some devices may take significant time. To avoid 
unnecessary delay and the possible loss of characters or picture elements, the 
speed of the output terminal should be specified. 


By default the speed is set to 1200 bauds. Aslower speed could be set by issuing 
the command: 


*PLOTPARM BAUDS = 300 


Where necessary, users should consult their computer advisor to ascertain 
appropriate settings. 


N.B. Most modern terminals do not require the BAUD rate to be specified. 
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TITLE 


This parameter was used previously to specify a job title for plotting but is now 
more commonly used to identify the type of plotter in operation. For example: 


*PLOTPARM PLOTTER = 7580 


would select a Hewlett Packard 7580 pen plotter. 


TRUSCALE 
This parameter is used when a plot is to be displayed on a graphic screen at its 
true size. The automatic scaling, which would normally fit the plot to the 
dimensions of the screen, will be switched off. 


N.B. \If this parameter is selected, the *ZOOM command available from the 
*COMPILE module (see Section 6) should not be used. 
NOLOGO 
This parameter switches off the GIMMS logo automatically generated by the 
*NEWMAP command (see Section 6). 
3.3.1.4 *TEXTPARM Command 
The *TEXTPARM command can be used to set parameters defines the general format 
and appearance of plotted text strings. These text strings may be specified by the 
command *TEXT (see Section 6), or automatically generated by commands such as 


*LEGEND (see Section 6). 


Within the *TEXTPARM command the following parameters are available: 


REPEAT (TIMES) /|,PERM/ specifies number of repeats for 
over-drawing 

SHIFT /R, =0.01,PERM/ specifies distance between 
repeats 

BLOCK /K,PERM/ selects block repeat 

ALPHABET (FONT) (ALPHA) /\,PERM/ specifies alphabet style 

RATIO /R, = 1.0,PERM/ specifies compactness of 
characters 

NLRATIO (NLR) /R, = 1.0,PERM/ specifies space between lines of 
text 

UNDERLIN (UNDER) /K,PERM/ switches on text under-lining 

ITALIC /R, = 0.28,PERM/ sets degree of siant for italic 
characters 

SHADE /K,PERM/ switches on text shading 


N.B. Parameters set by *TEXTPARM can be over-written from within *TEXT 
commands. For example, if the alphabet style was set by *TEXTPARM to 12 
(*TEXTPARM ALPHABET = 12), alphabet style 16 could be selected within a * TEXT 
command (*TEXT... ALPHABET = 16...) to plot a specific text string. Some of the 
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parameters set by *TEXTPARM may also be modified within text strings using @ 
codes (see Appendix A). 


Further Notes on *TEXTPARM Parameters 
REPEAT, SHIFT,BLOCK 


These parameters define the number of times and the manner in which text 
strings are redrawn. They can be used together to thicken lettering. 


REPEAT specifies the number of times a string is to be redrawn, while SHIFT 
specifies the distance the pen will move between repeats. For example: 


*TEXTPARM REPEAT =4 SHIFT =0.02 


This command will result in a specified text string being redrawn 4 times 
(REPEAT =4): each time the pen will be moved 0.02 centimetres (SHIFT =0.02). 
The SHIFT routine however, incorporates an additional feature which causes 
sucessive repeats to be applied in a semi-circular fashion so that drawing lines 
will be evenly ‘thickened’. 


If BLOCK 1s specified, each repeat again has the SHIFT value applied, but only in 

the +X and +/Y directions. Some lines within individual characters therefore, 

will not be ‘thickened’ (e.g. the diagonal line of the Z character) and lettering 

may appear uneven. 

N.B. The REPEAT parameter can be expensive to use in terms of drawing time, 
especially when long text strings are required. If the alphabet style is 
chosen appropriately, the necessity for REPEAT can be avoided. 


It is inadvisable to use REPEAT with shaded text strings. 


ALPHABET 


This parameter selects the alphabet style to be used when text is plotted. Tables 
of available styles are given in Appendix B. For example: 


*TEXTPARM ALPHABET = 12 


would select a simple, single stroke alphabet style. 


RATIO 
This parameter defines the compactness of characters when text is plotted. After 
characters have been scaled to the selected size, the coordinates that define their 
shape have the following transformation applied to them: 


X' = X*RATIO 


Altering the value for RATIO can therefore significantly affect the appearance of 
an alphabet style. 
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By default, RATIO is set to 1.0. This produces characters of normal width. If 
RATIO is less than 1.0 (e.g. *TEXTPARM RATIO = 0.75), the width is compressed in 
the X-direction and ‘tall, thin’ characters are produced; if it is greater than 1.0 
(e.g. *TEXTPARM RATIO = 2), the width is extended and ‘short, wide’ characters 
are generated. 


RATIO is a useful parameter to reduce the width of text strings in map titles and 
notes. 


NLRATIO 


This parameter affects the spacing between succeeding lines of text i.e. the gap 
between the nominal bottom of one line of text (excluding ‘trailers’) and the 
nominal top of the next. 


By default, this space is equivalent to half (0.5) the specified character height and 
is represented by NLRATIO=1.0. For example, if the character height is 1.0 
centimetres, the gap between succeeding lines of text would be 0.5 centimetres. 


A value for NLRATIO of more than 1.0 (e.g. *TEXTPARM NLRATIO = 1.5) produces 
larger spacing between succeeding lines of text, while a value of less than 1.0 
(e.g. *TEXTPARM NLRATIO =0.85) results in smaller spacing. 


UNDERLIN 


This parameter switches on automatic UNDERLINing of text strings. It Is 
described fully in Appendix A. 


ITALIC 


This parameter defines the degree of slant applied to italic lettering produced by 
the use of the @I option (see Appendix A). 


The default setting is 0.28. A value greater than 0.28 (e.g. *TEXTPARM 
ITALIC = 0.32) will produce more slanted lettering, while a value less than 0.28 
(e.g. *TEXTPARM ITALIC =0.2) will result in more up-right lettering. A value less 
than zero will generate lettering slanting to the left. 


N.B. The parameter ITALIC only specifies the degree of slant; it does not select 
slanted (or italic) lettering. This is achieved using the @! code within a text 
string (see Appendix A). 
SHADE 


When open alphabet styles are selected, i.e. alphabets numbered 60 and over, 
this parameter will automatically shade characters with solid fill. 


N.B. It is inadvisable to use the REPEAT and SHADE options simultaneously. 


Examples of the effect of these parameters, together with others available in the 
command *TEXT, are illustrated in Figure 6.5. 


s= 17 


3.3.1.5 *STOP Command 


This command is used to terminate a GIMMS command run and return control to 
the operating system. 


*STOP ts required for normal program termination. If itis not issued GIMMS will 
terminate abnormally, printing the message: 


**** END OF INPUT **** 
Abnormal termination may have several adverse effects. For example, a plot file 
may be incomplete or the last command issued may not be executed. 
3.3.5.0 Commands to Access Application Modules and Subsystems 


The following commands are fully described in the appropriate sections and divide 
into two types: 


Modules Commands - 


*PLOTPROG - see Section 6 
*COMPILE - see Section 6 
*GRAPHICS - see Section 7 
*MANIPULATE - see Section 8 
* UTILITIES - see Section 9 


N.B. Commands to access modules require the command *END to return control to 
the Main Control Program. 


Subsystem Commands - 


*FILEIN - see Section 4 
*POLYGON - ee Section 5 
*CHECK - see Section 5 


3.3.6.0 Miscellaneous Commands 

There are several miscellaneous commands within the Main Control Program. These 
support various facilities, the main ones of which are data storage and retrieval, file 
information, outline drawing and documentary text. Some of these commands are 
also available from within application modules. 


3.3.6.1 *CALL Command 


This command Is used to access macros from either User Libraries or the System Library. 
The general format of the command is: 


*CALL <macroname> <list of parameters> * 


*CALL is fully described in ‘The GIMMS Macro Guide’ (Carruthers, 1988), published by 
GIMMS Ltd., Edinburgh. 
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3.3.6.2 *SAVE Command 


*FILEIN can be used to create or add data to GIMMS non-locational data files (see 
Section 4). Several other commands may also be used calculate new data variables 
(see Section 8). Generally, these data variables will be stored in a standard data file 
using the DATA parameter in *FILEPARM and will be retrieved from there on 
subsequent command runs (see Section 3.3.1.2). Data files created using the command 
*FILEPARM DATA will be direct access. *SAVE however, will save the data in 
sequential files. On some computer systems this may reduce the disk space required. 


The general format of the command is: 
*SAVE DATAFILE TO FILE 13 


where the file in which the GIMMS non-locational data will be stored has been 
previously assigned by the user in this case to channel 13. 


*SAVE ts fully described in Section 9. 
N.B. The commands *SAVE and *RESTORE have been largely replaced by the 
availability of the *FILEPARM DATA command (see Section 3.3.1.2). This 


command automatically assigns a non-locational data file to channel 21 from 
where it can be written to or accessed as required. 


3.3.6.3 *RESTORE Command 

When non-locational data variables have been written to a GIMMS data file using the 
command *SAVE, they may be accessed for subsequent GIMMS command runs using 
*RESTORE. 

The general format of the command is: 


*RESTORE DATAFILE FROM FILE 14 


where the file containing the GIMMS non-locational data has been previously 
assigned by the user in this case to channel 14. 


*RESTORE is fully described tn Section 9. 

N.B. The commands *RESTORE and *SAVE have been largely replaced by the 
availability of the *FILEPARM DATA command (see Section 3.3.1.2). This 
command automatically assigns a non-locational data file to channel 21 from 
where it can be accessed or written to as required. 


3.3.6.4 *FILEINFO Command 


This command allows users to obtain descriptive information relating to GIMMS data 
files. 


Within the *FILEINFO command the following parameters are available: 


FILE /\/ specifies channel number to reference file 
ALL /K/ prints full information 
NAMES /K/ prints names of variables or zones 


a=19 


DATAFILE (DATA) /K/ selects non-locational DATA file 
GRIDFILE (GRID) /K/ selects GRID file 


Further Notes on *FILENFO Parameters 


FILE, DATAFILE, GRIDFILE 


These parameters identify the channel number on which a GIMMS data file has 
been referenced by the user. Either the channel number should be specified 
using FILE, or the keywords DATAFILE or GRIDFILE issued, depending on the type 
of GIMMS data file being interrogated. For example: 


*FILEINFO FILE = 13 


would select a GIMMS datafile previously assigned by the user to channel 13 
using the command *FILEPARM (see Section 3.3.1.2). 


The information returned to the user would consist of the file name and file 
type (ile SEGMENT, DATAFILE, etc). 


If a locational data file is being interrogated (i.e. POINT, LINE, SEGMENT or 
POLYGON), values for the sheet and zone envelopes will also be returned. 


The sheet envelope identifies the mintmum and maximum coordinate values 
Stored in the locational data file. These values are equivalent to the LIMITS 
recorded when the data was captured (see Section 4). The zone envelope 
identifies the minimum and maximum _ coordinate values enclosing the zones 
Stored in the file. 


ALL 
This parameter lists the details stored in the file header. In addition, if a polygon 
file is being interrogated, the zone names will be printed. If a DATAFILE or 
GRIDFILE is being interrogated a list of the variable names and types will be 
output. This information is particularly useful when data variables are to 
undergo further processing. 

NAMES 


If a polygon file is being interrogated, this parameter will print the zone names. 
If a DATAFILE or GRIDFILE ts being interrogated, a list of the variables will be 
output. 


3.3.6.5 *DRAWMAP Command 


The *DRAWMAP command ts used to plot GIMMS locational data files. The general 
format of this command is: 


*DRAWMAP FILE = 11 OUTLINES = ALL 


In this command string, the locational data file has previously been assigned by the 
user to channel 11 using the command *FILEPARM (see Section 3.3.1.2). GIMMS will 
automatically scale and position the locational data within the plotting window. 


The dimensions of the map can may be modified using the parameter MAPSIZE. For 
example: 


*DRAWMAPFILE = 11,OUTLINES = ALL,MAPSIZE = 40,50 
N.B. These dimensions are in centimetres. 


The *DRAWMAP command is fully described in Section 6. 


3.3.6.6 *TEXT Command 


Ifa *DRAWMAP command has been issued, the command *TEXT can be used to add 
text to the map. For example: 


*TEXT TEXT ='Map Title’ ALPHABET = 16 POSITION =0.5,1 SIZE =0.7 


This command would plot the specified text string (enclosed by primes) in alphabet 
style 16 (see Appendix B), beginning at the position (0.5,1) centimetres, measured 
from the bottom left corner of the plotting window. The size or height of the text 
would be 0.7 centimetres. 


The *TEXT command is fully described in Section 6. 


3.3.6.7 *BOXING Command 


This command accesses an interactive game for up to four players. The purpose of 
this game is to complete the outline of boxes by pointing at their edges using the 
graphic cursor. Because of this graphic requirement, *BOXING can only be played on 
graphic terminals such as the Tektronix 401X or 41XX series. 


*BOXING was kindly provided by Geoff Dutton of the Laboratory for Computer 
Graphics, Graduate School of Design, Harvard University. 
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4.0.0.0 *FILEIN APPLICATION MODULE 
The *FILEIN Application Module is designed to input both locational and non- 
locational data. Parameters are available to describe data, specify how it is to be read 
and direct where it is to be stored. 
4.1.0.0 LOCATIONAL DATA INPUT 
The following example illustrates the commands required to input locational data: 
*FILEPARM 10 'UKSEGS’ GIMMS OUT 
*FILEIN 
FILEOUT = 10,FILENAME = UK 
TYPE = SEGMENT 
LIMITS = 2000,700,3100,2600 
TITLE = Segments for UK Regions’ 
BEGIN 
SEGMENTS 
<description of segments > 
END 
*STOP 


These commands are described below. 


*FILEPARM 10 ‘UKSEGS' GIMMS OUT 


This command attaches a file called '‘UKSEGS' to channel 10. This is a GIMMS file 
and will be created (OUT) as a result of the current GIMMS command run. 


The command *FILEPARM ts fully described in Section 3.3.1.2. 
N.B. Channel number may vary depending on machine/ installation sites. 
Users should consult their local computer advisor. 
*FILEIN 


This command accesses the *FILEIN Application Module. 


FILEOUT = 10, FILENAME = UK 


The parameter FILEOUT determines where the GIMMS data file will be stored. In 
this example, FILEOUT directs output to channel 10. This channel was previously 
assigned by the *FILEPARM command. 


The parameter FILENAME allocates an internal name to the output file. This 
name may be up to 10 characters long, the first of which MUST be a letter. 


TYPE = SEGMENT 


This parameter specifies the data type being input. Four types of locational data 
are available: SEGMENT, AREA, LINE and POINT. These are discussed below. In 
this example, SEGMENT data has been selected. 


LIMITS = 2000,700,3100,2600 


This parameter specifies the bottom left (origin) and the top right corners of the 
map being digitised and is equivalent to the sheet envelope. Coordinates 
entered to describe the locational data should fall within these LIMITS. 


Values for LIMITS must be positive integers. In this example, the bottom left 
corner has the coordinate value (2000,700) while the top right has the 
coordinate value (3100,2600). The dimensions of the map are therefore 1100 
map units along the X axis and 1900 map units along the Y axis. 


LIMITS determine the extent of the locational data and are used in the mapping 
module *PLOTPROG, to automatically scale map outlines (see Section 6.1.3.2). 


TITLE = ‘Segments for UK Regions: 


This parameter may be used to document the data being recorded. It provides a 
convenient way for users to comment on the contents of a file and can serve asa 
useful reminder at alater date 


TITLE information must be enclosed by primes ("') and will be printed if the data 
file is interrogated using the command *FILEINFO (see Section 3.3.3.4). 


BEGIN 


This parameter signifies the start of data entry. 


SEGMENTS 


END 


This parameter specifies that the data following describes SEGMENTS. 


A description of the segment data required to produce Figure 4.1 is given in 
Section 4.1.1.0. 


This parameter terminates data input and returns control to the Main Control 
Program. 


*STOP 


This command terminates the GIMMS command run. 


4.1.1.0 Recording Locational Data 


Three types of locational data may be recorded: 


1. 


Areas 


An area is defined in terms of the line which encloses it. This line is described by a 
series of X,Y coordinates which, when plotted on a map, are joined together by 
straight lines. 


When areas are composed of straight line boundaries, (see Figure 4.1), 
comparatively few coordinates need be recorded. When boundaries are irregular 
however, many more coordinates will be required to achieve good representation. 


N.B. It is best to describe boundaries by many, rather than few, coordinates as 
GIMMS has the facility to produce generalised outlines from complex areal 
data (see Section 4.3.1.0 under REDUCE). 


Areas may be described by the data types SEGMENT and AREA. 


When coordinates are input as SEGMENT data, only that part of a boundary which 
is common between two adjacent areas is recorded. Several SEGMENTS are 
therefore generally required to describe a single area. 


When coordinates are input as AREA data, the complete polygon is described by a 
single line. Consequently, the line must have the same coordinate values repeated 
for the start and end points. When more than one area is described by this 
method, it is the responsibility of the user to ensure that common boundaries 
match. If they do not, gaps will appear between adjacent areas when they are 
plotted. 


Kegions of 
Great Britain 








FIGURE 4.1 


If locational data is captured by an electronic digitiser, it is advisable to record 
areas as SEGMENTs. Adjacent boundary lines will then only have to be traced 
once. If data is recorded as AREAs, it is extremely unlikely that common 
boundaries will match due to the high degree of accuracy inherent in this 
recording device. 


An example of SEGMENT data input follows and describes the boundaries 
recorded in Figure 4.1. The commands used are described in Section 4.1.0.0. 


*FILEPARM 10 'UKSEGS' GIMMS OUT 


*FILEIN 
FILEOUT = 10 FILENAME = UK 


TYPE =SEGMENT 


LIMITS = 2000,700,3100,2600 
TITLE ='U.K. Regions recorded as SEGMENT data’ 


BEGIN 

SEGMENTS 

ZO1 SEA 2618 931 2094 792 2247 988 2436 1025 2480 1107 / 

Z06 SEA 2480 1107 2361 1059 2149 1162 2303 1256 2304 1360 
2222 1360 2430 1431 / 

Z08 SEA 2430 1431 2456 1611 / 

Z09. SEA 2456 1611 2356 1700 2378 1780 / 

Z09 SEA 2538 1947 2681 1690 / 

210 SEA 2378 1780 2200 1709 2227 2011 2102 1851 2188 2154 
2124 2092 2074 2144 2208 2515 2410 2525 2294 2288 
2540 2326 2487 2122 2399 2064 2470 2035 2375 1992 
2538 1947 / 

ZO7 SEA 2681 1690 2776 1615 2783 1488 / 

Z04 SEA 2783 1488 2837 1348 / 

203) SEA 2837 1348 2970 1388 3027 1305 2958 1194 / 

ZO2. SEA 2958 1194 2868 1090 3001 1083 2985 1028 2618 931 / 

Z01 205 2480 1107 2511 1186 2612 1186 / 

201 202 2612 1186 2618 931 / 

ZO2. 205 2612 1186 2648 1215 / 

ZO2. 204 2648 1215 2738 1240 / 

202. 203 2738 1240 2958 1194 / 

203. 204 2738 1240 2837 1348 / 

Z04. 205 2648 1215 2569 1423 / 

Z04 208 2569 1423 2569 1488 / 

Z04 20/7 2569 1488 2783 1488 / 

Z05 206 2480 1107 2419 1273 2474 1378 / 

205 208 2474 1378 2569 1423 / 

Z06 208 2430 1431 2474 1378 / 

ZO07 208 2569 1488 2495 1622 / 

207, 209 2495 1622 2681 1690 / 

Z08 209 2456 1611 2495 1622 / 

Z09. 210 2378 1780 2538 1947 / 

END 

*STOP 


When this data is processed, it will produce highly generalised boundaries. 
Although segments will be stored in relative positions to each other, they will 
not at this stage be linked together to form closed areas or polygons. It is 


therefore not possible to use this data, together with related statistics, to 
generate area shaded maps. 


The creation of polygons from SEGMENT data |s described in Section 5. 

2. Lines 
A line is similar to an area in that it is also described by a series of X,Y 
coordinates. Although lines may be processed as SEGMENT data, it is more usual 
to define the coordinates as data type LINE. 

3. Points 


A point records a discrete location. It is described by a single X,Y coordinate and 
defined as data type POINT. 


4.1.2.0 Coordinate Input 


Coordinates may be generated manually by reading references from a map or more 
accurately, by means of an electronic digitiser. 


Coordinate values must be integer numbers, separated from each other by atleast one 
space or comma. In addition, these values may be preceded by a plus or minus sign, 
where appropriate. 


4.1.3.0 AREA and SEGMENT Data Input 


When input as data type AREA, coordinates for each zone must be preceded by the 
zone name and must be terminated by aslash (/). For example: 


203 2958 1194 3027 1305 2970 1388 2837 1348 2738 1240 2958 1194/ 


N.B. The zone name must be separated from the first coordinate by at least one space 
or comma and the same coordinate values must appear for the start and end 
points i.e. (2958, 1194). 


When input as data type SEGMENT, a minimum of two zone names must be specified 
at the start of each coordinate list. For example: 


Z05 206 2480 1107 2419 1273 2472 1378/ 


The zone names in this case, represents the areas to the right and left of the segment 
being recorded (see Figure 4. 1). 


N.B. The order in which zones names are specified for SEGMENT data will determine 
the direction of digitising. In the above example the direction is clockwise, 
around zone ZO5. 


4.1.4.0 LINE Data Input 


The input of LINE data follows the same general format as AREA data, |.e. each line is 
referenced by a name and described by a series of coordinates, terminated with a 
slash (/). For example: 


LINEO1 2681 1690 2776 1615 2783 1488 / 


In this case, the coordinate values for the start and end points do not have to match. 


4.1.5.0 POINT Data Input 


Points are input as a list of discrete X,Y coordinates. Individual points are not 
referenced by a zone name and values only need be separated from each other by a 
space or comma. For example: 


2480 1107 2419 1273 2474 1378 / 
In this example, coordinate values are input for 3 points. 


N.B. Aslash (/) is required to terminate the list of coordinates for POINT data input. 


4.1.6.0 Keywords to Control Locational Data Input 


After the directive BEGIN has been issued, coordinate data must be preceded by an 
appropriate keyword to describe the data type being input. For example, segment 
data would be preceded by the keyword SEGMENTS, line data by the keyword LINES 
and point data by the keyword POINTS. 


Coordinate data input is terminated by the keyword END. This returns control to the 
Main Control Program from where *STOP may be issued to terminate the GIMMS 
command run. 


4.2.0.0 NON-LOCATIONAL DATA INPUT 


Non-locational data describe geographical distributions, such as the percentage of 
agricultural land within defined economic regions, or the ratio of private to rented 
dwellings within electoral constituencies. 


The following commands may be used to input non-locational data: 
*FILEPARM DATA ‘UKDATA’ GIMMS OUT 


*FILEIN 

FILENAME =REGDATA 

TYPE = DATAFILE 

TITLE = ‘Data for U.K. Regions’ 
ZONES = 10, VARS = 2 

NAMES =POP,MANUF 


BEGIN 
54230 17921 
180000 18432 


123476 15/62 
114076 13618 
125854 11571 
120672 45258 
113421 23291 
89765 12092 
98762 31245 
109872 42567 


*STOP 


These commands are described below. 


*FILEPARM DATA 'UKDATA’ GIMMS OUT 
This command attaches a file called UUKDATA’ using the parameter DATA. This is 
a GIMMS file and will be created (OUT) as a result of the current GIMMS 
command run. 


The command *FILEPARM is fully described in Section 3.3.1.2. 


N.B. Channel number may vary depending on machine/ installation sites. Users 
should consult their local computer advisor. 


*FILEIN 


This command accesses the *FILEIN Application Module. 


FILENAME = UKDATA 


This parameter allocates an internal filename to the output file. This name may 
be up to 10 characters long, the first of which MUST be a letter. 


TYPE = DATAFILE 


Parameter DATAFILE signifies that non-locational data will follow. 


TITLE = ‘Data for U.K. Regions: 


This parameter can be used to document the data being recorded. It provides a 
convenient way for users to comment on the contents of a file and can serve as a 
useful reminder at a later date. 


TITLE information MUST be enclosed by primes ("') and will be printed if the data 
file is interrogated using the command *FILEINFO (see Section 3.3.3.4). 


ZONES = 10, VARS = 2 


The parameter ZONES specifies the number of areas or polygons to which non- 
locational data will be allocated. 
corresponding to the 10 polygons in Figure 4.1. 


In this example, there are 10 zones 


The parameter VARS states how many variables will be entered. 


NAMES = POP,MANUF 


Parameter NAMES may be used to allocate names to the variables being entered. 
These names may be up to 10 characters long, the first of which MUST be a letter. 
In this example, the first variable will be called POP and the second MANUF. 


BEGIN 


This parameter signifies the start of data entry. It is followed by a list of non- 
locational data values. The left column represents variable POP while the right 
column represents variable MANUF. 


N.B. The order in which non-locational data values are issued MUST match the 
order in which the locational data polygons are stored and plotted. If they 
do not match GIMMS will allocate data to the wrong zones. 


*STOP 


This command terminates the GIMMS command run. 


4.3.0.0 *FILEINCOMMAND 


The *FILEIN command accesses the GIMMS Application Module designed to input 


locational and non-locational data. 


Within *FILEIN the following parameters are available: 


FILEQUT (OUT) (FILE) /\/ 
FILENAME (OUTNAME) (NAME) — /L/ 
FILEIN (IN) /\/ 

TYPE /\/ 
SEGMENT /K/ 
AREA (POLYGON) /K/ 
POINT /K/ 

LINE /K/ 
DATA (DATAFILE) /K/ 

GRID (GRIDFILE) /K/ 
LIMITS (XL) (WEST) /\/ 

YL (SOUTH) /\/ 

XH (EAST) /\/ 

YH (NORTH) /\/ 
NONODES /K, =ON/ 
MAXTOL /\,=K:TOL/ 


identifies output channel 

specifies internal name for output file 
identifies input channel 

selects data type 

specifies SEGMENT data 

specifies POLYGON data 

specifies POINT data 

specifies LINE data 

specifies non-locational DATA file 
specifies GRID file 

specifies west limit 

specifies south limit 

specifies east limit 

specifies north limit 

specifies no node matching 

sets MAXIMUM tolerance for node and 
centroid matching 


TOL (RANGE) /\, = 10/ sets INITIAL tolerance for node and 
centroid matching 


TITLE (TEXT) /S/ specifies internal title for output file 

AUTONODE /K/ switches on autonode match-ing 

REDUCE // reduces digitised lines by specified band 
width 

NODES (CENTROID) /\,=1000/ specifies maximum number of nodes 
and centroids 

RUNLEN /K/ specifies run length encoding 

OS /K/ specifies processing of Ordnance Survey 
(DMC) map data 

USER /K/ accesses user subroutine UINPUT 

POLYGRID /K/ creates polygon files from grid 
centroids 

FROMDATA /K/ creates point files from data values 

USERCODE /\/ specifies value for USER subroutine 

INCLUDE (SELECT) /K/ selects features from Ordnance Survey 
DMC data 

CODES (FEATURE) /\/ selects codes (e.g. Ordnance Survey 
feature codes) 

TO /K/ links code sequences 

BEGIN (GO) (RUN) (START) /K/ initialises data entry 

ZONES /\/ specifies number of zones to be input 
(DATA, GRID and POINT files only) 

VARS /\/ specifies number of variables to be 
input (DATA, and GRID files only) 

EXTRA /\/ creates extra space for DATA or GRID 
file variables 

FORMAT /S/ specifies format for non-locational data 

BASENAME (BASE) /L,='V'/ specifies basename for DATA file 
variables 

NAMES (VARNAMES) (VAR) /L,REPEAT/ lists variable names for DATA or GRID 
file input 

ABSOLUTE (ABS) (A) /K/ selects ABSOLUTE variables 

DENSITY (DEN) (D) /K/ selects DENSITY variables 

NEW /K,=ON/ — initialises DATA or GRID file (default 
setting) 

MERGE /K/ merges variables with existing DATA or 
GRID file 


These parameters are discussed in the remainder of this section. 


FILEIN, FILEOUT, FILENAME, TITLE 
Parameters FILEIN and FILEOUT are used to locate input and direct output. 


FILEIN specifies an input channel number and is used when data resides in an 
external file. For example: 


FILEIN = 13 
would read data from channel 13 after the directive BEGIN has been issued. To 


return control to the Main Control Program the last item in the external file 
should be the keyword END, unless DATA or GRID files are being processed. If 
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this keyword is omitted, GIMMS will attempt to read beyond the end of the 
external file and an operating system fault may occur. 


N.B. \f the data to be processed are included in the current GIMMS command 
run (as in the above examples), FILEIN need not be specified. 


FILEOUT specifies an output channel number. There is no default for this 
parameter, and a value MUST be supplied unless DATA or GRID files are being 
processed. 


FILENAME allocates an internal name to the output file, while the parameter 
TITLE can be used to document the file in more detail. 


The FILENAME may be up to 10 characters long, the first of which MUST be a 
letter. The TITLE may be of any length but MUST be enclosed by primes ("'). 


Parameters FILENAME and TITLE act as useful reminders at a later stage, on the 


contents of GIMMS data files. The information they contain will be printed if 
the data file is interrogated using the command *FILEINFO (see Section 3.3.3.4). 


4.3.1.0 Locational Data 


TYPE,SEGMENT, AREA, POINT and LINE 


These parameters are used to describe the TYPE of data to be processed. For 
example, if segment data is to be read, the following command would be 
issued: 


TYPE = SEGMENT 


Parameters SEGMENT, AREA, POINT, and LINE relate to locational data and only 
one of these data types may be selected within a single *FILEIN command. 


LIMITS, YL, XH, YH 


These parameters specify the dimensions of a map. The values issued are in map 
coordinates (or map units) and pin-point the bottom left and top right corners of 
the area being digitised. For example: 


LIMITS = 2000 700 3100 2600 


where the point (2000,700) identifies the bottom left corner and the point 
(3100,2600) identifies the top right corner. 


In the above example, the parameter names YL, XH and YH have been omitted 
and interpretation of the values relies on GPIS (see Section 2.2.2.0). 


N.B. Coordinates describing the locational data must fall within the LIMITS and 


may therefore require to be converted prior to processing (see Section 
4.3.1.1 under CONVERT). 


re 


AUTONODE, TOL, MAXTOL, NONODES 


When SEGMENT data is being processed, it is essential that the end points of 
adjacent segments match so as to create closed areas or polygons. 


AUTONODE switches on automatic end point matching and a Node Table is 
constructed to compare segment end points to recognised nodes. The end point of 
a segment will be joined to a node if it is located within a specified distance or 
TOLerance. If asegment end point lies outside the given TOLerance, its coordinates 
are entered into the Node Table for comparison with subsequent end points. 


When small segments are being recorded and the distance between start and end 
points is less than the TOLerance value, the segment will collapse to a single node. 
To overcome this problem nodes may be explicitly entered into the Node Table 
(see below under NODES). 


TOL specifies the distance used to match segment end points to recognised nodes. 
It is expressed in map units. Conceptually, TOL defines a square around each 
segment end point. The end point is at the centre and each side of the square is 
twice the length of the TOL value. When a segment end point is compared, it will 
be attached to the nearest node within the square. 


The value for TOL may be altered during a GIMMS command run. This is achieved 
by issuing an alternative TOL value immediately before the appropriate co- 
ordinate string(s). This TOL value will remain in force until it is changed again or 
until the end of the GIMMS command run. 


When more than one TOL value is used within a GIMMS command run, a value 
MUST be set for the parameter MAXTOL. This should correspond to the maximum 
TOL value required. 


If it is Known that all segment end points match, node checking may be switched 
off using the parameter NONODES. This condition may arise if the data has been 
generated from asegment filedump (see Section 9.4.0.0). 


N.B. NONODES is the default setting. 


NODES 


This parameter may be used to increase the number of nodes and/or centroids to 
be processed. By default, this value is set to 1000. 


N.B. \|t is advisable to set the value for NODES to approximately three times the 
maximum number of nodes and/or centroids required (see Section 4.3.1.4). 


REDUCE 
This parameter may be used to reduce the number of points describing segments 
prior to output. In effect, the segments are generalised using the method of 
minimum offset (the Douglas/Peucker algorithm). The value for REDUCE is 
expressed in map units and represents the offset. For example: 


REDUCE = 20 
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would remove all points within a tolerance distance of 20 map units from the 
general trend of the line. 


RUNLEN 


This parameter may be used to reduce the volume of SEGMENT, LINE or AREA 
coordinate data. 


Where the coordinate system used involves large numeric values, individual 
coordinates may comprise several digits. For example: 


Z05 206 2480 1107 2419 1273 2474 1378/ 


This can result in storage problems as the space occupied by coordinates will be 
extensive. It may be useful therefore to describe segments or polygons using run 
length encoding. 


With run length encoding, first X,Y coordinate is entered in full, but all subsequent 
points are described as relative differences in X and Y. For example, the following 
run length sequence describes the short segment 205/206 referred to above: 


Z05 Z06 2480 1107 -61 166 53 105/ 

In this example, the saving amounts to 5 out of 29 characters i.e. almost 20 percent, 
and will represent a considerable saving when large numbers of coordinates are 
being generated. 
N.B. |If RUNLEN is not specified all coordinates must be entered in full. 

OS 
This parameter is used when Ordnance Survey DMC map data is being read. 
Ordnance Survey DMC data may be used to create POINT, LINE or SEGMENT files 
and the parameter OS should be followed by the data type being processed. For 
example: 

OS, LINE 

would read LINE data. 
Different map attributes may be selected using appropriate feature codes (see 
below). These codes are described in the documentation accompanying Ordnance 
Survey DMC map data. 

INCLUDE, CODES, TO 


These parameters can be used to select features from Ordnance Survey DMC map 
data. 


A maximum of 20 feature codes or code ranges may be specified. Individual 
feature codes must be separated by a comma or a space; code ranges use the 
parameter TO. For example. 


INCLUDE 15 TO 40, 45, 60 TO 70 
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would select features 15 to 40 inclusive, feature 45, and features 60 to 70 inclusive. 


A description of the feature codes available is given in the documentation 
accompanying Ordnance Survey DMC map data. 


USER, USERCODE 


The parameter USER facilitates a mechanism for users to input their own data i.e. 
from an external database. It is used to access a user-supplied subroutine for each 


zone being input. 


GIMMS Ltd. for a description of the interface. 


The 


subroutine for whatever purpose is required. 


4.3.1.1 Locational Data Entry - The Keyword BEGIN 


This subroutine is called UINPUT and users should contact 


parameter USERCODE allows the user to pass an integer value into the 


Locational data entry Is initialised by the keyword BEGIN. A number of parameters are 
available at this stage to control the way in which data is processed: 


SEGMENTS (BOUNDS) (SECTIONS) (SEGMENT) 


/K,PERM/ selects segment input 
POLYGONS (AREAS) (POLYGON) /K,PERM/ selects polygon input 
POINTS (POINT) /K,PERM/ selects point input 
LINES (LINE) /K,PERM/ selects line input 
NODES (NODE) /K,PERM/ selects node input 
CENTROIDS (ZONES) /K,PERM/ selects centroid input 


DIAGS 
RANGE (TOL) (MATCH) 
CONVERT (TRANS) (RESET) 


/l, =(C:SYSPARM)/ 
/\, TOL(C: FILEIN)/ 
[REPEAT = 16/ 


specifies diagnostic level 
specifies tolerance 
performs affine transformation 


SEQUENCE (SEQNO) /\/ sets sequence number 

ABSBEGIN (ABSX1) /R/ specifies absolute start point of 
segment (X value) 

ABSY 1 /R/ specifies absolute start point of 
segment (Y value) 

ABSEND (ABSX2) /R/ specifies absolute end point of 
segment (X value) 

ABSY2 /R/ specifies absolute end point of 


NAME (NAMES) 


COORDS (VALUES) (XY) 
END (STOP) (FINISH) (BYE) 


/L,REPEAT = 30/ 


/RV/ 
/K,EXIT/ 


segment (Y value) 

specifies names of segments, 
polygons or lines 

specifies coordinate values 
terminates data input 


SEGMENTS, POLYGONS,POINTS,LINES,NODES,CENTROIDS 


These parameters describe the type of data to be processed. 
SEGMENTS 


When SEGMENT data is being processed, a maximum of 30 names (15 pairs of zone 
names) may be associated with each segment. This facility can be used to create a 
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hierarchical labelling system, with successive pairs of zone names referring to 
different levels. 


Segment labels may be selected within the sub-system *POLYGON using the 
parameters MINZONE, MAXZONE and ALPHA (see Section 5.1.0.0). These 
parameters facilitate the selection of particular labels to generate different 
polygon files corresponding to the different levels recorded. Polygon selection 
operates on unique combinations of alphabetic characters being assigned to each 
level in the hierarchy. 


For example, at the lowest level Wards may exist, followed by Districts, and at the 
highest level, by Counties. Labels referring to wards may begin with 'W’', those for 
districts may begin with 'D' and those for counties may begin with ‘C’. Asegment 
which represents only a ward boundary would therefore be referenced by 2 labels; 
a segment which represents both a ward and district boundary would be 
referenced by 4 labels; and a segment which represents a ward, district and 
country boundary would be referenced by 6 labels. 


Figure 4.2 illustrates a portion of amap covering 2 counties (numbered 23 and 27). 
County 27 includes 3 districts (numbered 10, 12, and 15). District 12 includes 2 
wards (numbered 024 and 025) and district 10 includes 1 ward (numbered 107). 
The portion of county 23 includes district 19 and ward 045. 
Three segments (A, B, and C) are marked to denote: 

A : ward boundary only 


B : ward and district boundary only 
C : ward, district, and county boundary 


These segments may be labelled and input as follows: 


<Segment A> 
W024 W025 ... coordinates ... / 


<Segment B> 
W025W107 D12D10 ... coordinates ... / 


<Segment C> 
W007 W045 D10D19 C27 C23 ... coordinates... / 
When processed using *POLYGON (see Section 5.1.0.0), a polygon file describing 
wards may be created by the command: 


*POLYGON MINZONE = W000, MAXZONE = W999, ALPHA 


This command would select only the zones beginning with ‘W’, and order them 
alpha-numerically. 


A245 
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FIGURE 4.2 
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Similarly, a polygon file describing districts may be created by the command: 
*POLYGON MINZONE = DOO, MAXZONE = D99, ALPHA 

Finally, a polygon file describing counties may be created by the command: 
*POLYGON MINZONE = C00, MAXZONE = C99, ALPHA 


The above example assumes that all ward, district, and county names are unique 
(i.e. there is only one ward called W024 etc.). If wards were labelled separately 
within each district, without regard to wards in other districts, it would not be 
possible to select and create a ward polygon file using the above method. 
Instead, a composite hierarchial label would have to be designed. For example, 
the four wards identified in Figure 4.2 could be labelled: 


Label Meaning 
22712024 County 27, District 12, Ward 024 
22712025 County 27, District 12, Ward 025 
22710107 County 27, District 10, Ward 107 
22319045 County 23, District 19, Ward 045 


and segments A, B and C coded as follows: 


<Segment A> 
22712024 22712025.... coordinates... ./ 


<Segment B> 
22712025 2Z2710107.... coordinates... ./ 


<Segment C> 
22710107 22319045.... coordinates... ./ 


When processed using *POLYGON (see Section 5.1.0.0), a polygon file describing 
wards may be created by the command: 


*POLYGON MINZONE = Z0000000, MAXZONE = 29999999, ALPHA 
Similarly, a polygon file describing districts may be created by the command: 
*POLYGON MINCOL= 1,MAXCOL= 5, 
MINZONE = Z0000, MAXZONE = 29999 
CULDESAC, ALPHA 
The parameter CULDESAC removes segments which have the same label on both 
sides as a result of using MINCOL and MAXCOL. CULDESAC is described in 
Section 5.1.0.0. 
Finally, a polygon file describing counties may be created by the command: 
*POLYGON MINCOL = 1, MAXCOL = 3, 
MINZONE = Z00, MAXZONE = 299 
CULDESAC, ALPHA 


In addition, a ward polygon file for County 23 may be created by the command: 


A257 


*POLYGON MINZONE = 22300000, MAXZONE = 22399999, ALPHA 
POLYGONS 


A polygon ts described by a single line. Consequently, the line must have the 
same coordinate values repeated for the start and end points. 


It is the responsibility of the user to ensure that the boundaries of adjacent 
polygons match exactly. 


POINTS 


Data for points is entered as a list of X,Y coordinates and values are separated 
from each other by spaces or commas. The final value is followed by a slash (/). 
Zone names are not associated with POINT data. 


The number of points to be read MUST be specified using the parameter ZONES 
prior to the keyword BEGIN. For example: 


ZONES = 12 
LINES 


The format for line data is similar to polygon data, except that the start and end 
points of each line do not necessarily match. 


NODES 


When many SEGMENT end points are clustered together within a set TOLerance 
distance, they may collapse to a single node. Similarly, when short segments are 
recorded they may also collapse during processing to a single node. The 
parameter NODES provides a means to overcome these problems as it allows 
users to explicitly enter segment end points into the Node Table BEFORE 
segments are digitised. 


CENTROIDS 


This parameter may be used to supply zone names together with coordinate 
values for their centroids to compile a Centroid Table. 


When a Centroid Table has been created, segments need not be referred to 
during digitising by zone names. Instead, the first two coordinates recorded for 
each segment are interpreted as the CENTROIDS of the zones on either side. 
Reference is then made automatically to the existing Centroid Table to extract 
the appropriate zone names. 


The general format of CENTROIDS data is as follows: 
CENTROIDS <centroids will follow > 
Z05 2500 1300/ 
Z08 2500 1500 / 


This example would enter two centroids into the Centroid Table, one for zone 
Z05 and one for zone Z08. 


If this was followed by the coordinate string: 
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SEGMENTS <select segment input > 
2500 1300 25001500 2474 1378 2569 1423/ 


the first two coordinates, (2500,1300) and (2500,1500), would be interpreted as 
centroids for the zones on either side of the segment being recorded i.e. Z05 and 
208. The coordinate string would therefore be equivalent to: 


SEGMENTS 
205 208 2474 1378 2569 1423/ 


Lists of centroids may be entered at any point within the coordinate data and 
may be issued in several blocks. However, as with labels, the order in which 
centroids are referenced when recording segments must be consistent as it 
reflects the direction of digitising (see Section 4.3.1.2). 


Recording centroids is particularly suited to automatic data collection and is 
useful when large numbers of segments are involved. It should be noted 
however, that when matching a centroid with the Centroid Table the existing 
TOLerance value is used. If more than one centroid is within the specified 
TOLerance, the segment is referenced by the zone name of the nearest centroid. 


If a segment is recorded and no match is located in the Centroid Table, the 
following error message will be issued: 


**** CENTROID NOT MATCHED **** 
and the segment ignored. 


The above error message may at times appear unexpectedly, perhaps because a 
segment has not been referenced correctly and one or more labels are missing. 
Alternatively, it may appear when a non-numeric character exits within the 
coordinate stream, generally as a result of machine malfunction or user error. 


Although using CENTROIDS means that zone names need only be entered once 
and digitising proceed at a faster rate, it will result in unlabelled data. 
Consequently, editing the source file to correct errors will be more difficult. It is 
generally inadvisable to use this method for large projects. 


For small projects however, where less than 100 zones are involved, arbitrary 
labels will be generated in the form A1, A2,...A999, B1, B2,... etc. This facility ts 
activated by entering CENTROIDS followed by a list of centroid coordinates with 
NO labels. 


DIAGS 
This parameter controls the volume of diagnostic information printed by 
*FILEIN. The diagnostic level may vary between 0 and 3. When DIAGS is 0 (i.e. 


DIAGS =0) no diagnostics will be produced; when DIAGS is 3 (i.e. DIAGS = 3) 
detailed diagnostics will be generated. Levels 1 and 2 are commonly employed. 
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RANGE, TOL, MATCH 


These parameters specify the TOLerance distance used in matching segment end 
points to nodes in the Node Table (AUTONODE), or zone centroids to values in 
the Centroid Table (CENTROIDS). 


When a segment end point is being matched, the Node Table is searched for a 
node that lies within the given TOLerance distance (see Section 4.3.1.0 under 
TOL). !f more than one node ts located the nearest is used. 


The TOL value remains in force until re-specified but should be restated each 
time a CONVERT Is issued (see below). 


TOL Is generally set to approximately 0.25 centimetres or 1/10 inch. The value for 
TOL will depend on the scale of the map being digitised and the resolution of the 
CONVERTed coordinates. 


CONVERT 


This parameter is used to transform digitiser coordinates to some other 
rectangular coordinate system, such as the Ordnance Survey National Grid of 
Great Britain. It is effected by describing four points on the map in both map 
units and digitiser coordinates. The coordinate data following CONVERT will be 
automatically transformed into map units. For example: 


CONVERT 
0 0 2000 700 
0 38000 2000 2600 
22000 38000 3100 2600 
22000 0 3100 700 


where map units appear on the left in the first two columns and digitiser 
coordinates appear on the right. Values for digitiser coordinates between 
2000,700 and 3100,2600 will be transformed to map units between 0,0 and 
22000,38000. 


It is advisable to choose the four reference points for CONVERT as far apart on 
the map as possible, for example, the four corner points. 


N.B. Values of TOL, MAXTOL, and LIMITS are expressed in map units and rely on 
CONVERTed coordinates. 


In many applications, digitiser coordinates will be adequate and it will not be 
necessary to CONVERT the coordinate data. 

SEQUENCE 
This parameter is used to specify the sequence number of the next SEGMENT 
recorded. Subsequent segments will be automatically numbered using an 
increment of 1. 


If no value is specified for SEQUENCE, numbering will begin at 1. 


N.B. There is no check for illegal sequence numbers. 
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ABSBEGIN, ABSEND 


Parameters ABSBEGIN and ABSEND may be _ used to force values for segment 
end points. This can be useful to correct errors related to sheet edge matching, 
and can also be used to correct problems with short segments and AUTONODE. 


For example, if the following command is issued within a segment: 

ABSBEGIN = 999,888 
the first point of that segment is set to (999,888), regardless of nodes stored in 
the Node Table. A similar effect is obtained using parameter ABSEND for the 
last pointin asegment. 


For example: 


Z05 206 2480 1107 2419 1273 1273 1378 
ABSBEGIN = 999,888, ABSEND = 111,222/ 


iS interpreted as: 
Z05 206 999 888 2419 1273 111 222/ 


If ABSBEGIN or ABSEND have been specified, node numbers will not be output in 
the diagnostic report but instead, the text ABS will be printed. 


NAME,COORDS 
These parameters are used to input coordinate data. The input consists of a list 
of names followed by a list of coordinates. The type of input (i.e. SEGMENTS, 
POLYGONS, LINES, POINTS, NODES or CENTROIDS) stays in force until it ts 


explicitly changed using the appropriate keyword. A slash (/) is required to 
terminate coordinate data input. 


SEGMENTS 


Consist of a maximum of 30 names (i.e. 15 pairs) followed by a string of 
coordinates. For example: 


205 Z06 2480 1107 2419 1273 2472 1378/ 
Data for each seqment MUST be terminated by a slash (/). 
POLYGONS 
Consist of a single name followed bya string of coordinates. For example: 


203 2958 1194 3027 1305 2970 1388 2837 1348 2738 1240 
2958 1194/ 


Data for each polygon MUST be terminated by a slash (/). 


LINES 
Consist of aname followed by astring of coordinates. For example: 
LINEO1 2681 1690 2776 1615 2783 1488 / 

Data for each line MUST be terminated by a slash (/). 

POINTS 

Consists of one or more coordinates. For example: 

2480 1107 2474 1378 2958 1194/ 

The last point MUST be terminated by a slash (/). 

NODES 

Consist of one or more coordinates. For example: 

2618 931 2480 1107 2430 1431 2456 1611/ 

The last point MUST be terminated by a slash (/) 

CENTROIDS 

Consists of one or more names followed by a coordinate. For example: 

Z05 2500 1300/ Z08 2500 1500 / 

Each name-coordinate pair MUST be terminated by a slash (/). 

N.B. In the above examples, the parameter names NAME and COORDS have 
been omitted and the interpretation of values relies on GPIS (see Section 
2.2.2.0). 

END, STOP, FINISH 


These parameters terminate locational data input and return control to the 
Main Control Program. 


It is important that input specified prior to these parameters has been 
terminated correctly. if it has not, the last piece of input may be lost. For 
example: 


Z08 209 2456 1611 2495 1622 / 
Z09 210 2378 1780 2538 1947 
END 


would result in segment Z09/Z10 being lost as it has not been terminated by a 
slash (/) prior to the parameter END. 


4.3.1.2 Notes on Digitising 


It is impossible to include a full description of map digitising in this Reference Manual 
but it is worth highlighting a few of the problem areas and making some 
recommendations: 


Preparation of Base Maps 


Base maps to be digitised should be good quality copies and have all the relevant 
information clearly and unambiguously marked, perhaps using coloured pencils. 


The four corners or LIMITS of the map should lie outside the study area and generally 
formarectangle. They should be clearly labelled with the appropriate map units. 


All zones to be recorded should be clearly identified and labelled. Labels should be no 
longer than 10 characters long, begin with a letter (‘A’ to 'Z') and be composed only 
of letters, numbers ('0' to '9'), and the full stop (.). 


Prior to digitising, the map should be firmly fixed to the digitising table and oriented 
with the bottom edge approximately parallel to the table edge. 


N.B. The ‘active’ surface of most digitising tables does not extend to the edge of the 
table. Itis therefore best to position the map centrally on the digitising table. 


Important Parameters 


It is important to correctly specify the values for LIMITS. These are used to 
automatically scale the data when it is plotted by the mapping Application Module, 
*PLOTPROG. 


It is also important to correctly specify the TOLerance value if AUTONODE is being 
used. Failure to do so may result in errors during polygon linkage In general, the 
TOLerance value should be set to the equivalent of about 3mm onthe map. 


N.B. The TOLerance value is specified in map units. 


Digitising 


Following aline on the map using a digitising cursor is reasonably straightforward and 
generally, data points are recorded in one of two ways: 


1. STREAM Mode Digitising 
Two methods of STREAM mode digitising are available, Time and Distance. 


The Time method records points at regular (small) time intervals. This 
method ts generally unsuitable, except for special applications, as it 
generates too many points and reflects the vibrations and irregularities of 
hand movement. 


The Distance method records a point only after the cursor has been moved 
a certain distance. It is generally preferred to the Time method. However, 
significant points may be omitted and many points may be generated for 
Straight lines. 


2. POINT Mode Digitising 


When the digitiser is used in POINT mode, the recording button on the 
cursor must be pressed for each point required. Care must be exercised 
when recording very irregular lines and many points should be digitised. If 
a line is definitely straight, recording the start and end point will be 
sufficient. 


POINT mode is recommended over STREAM mode. 
In almost all cases, more points will be recorded than are required. The parameter 


REDUCE however, may be applied to remove a percentage of the points without 
noticable loss of accuracy (see Section 4.3.1.0). 


Labelling and Direction of Digitising 


When SEGMENTS are being recorded it is essential that the direction of digitising Is 
consistent. This may be either clockwise or anti-clockwise. 


For example, Figure 4.2 identifies three segments A,B and C. The direction of 
digitising is as follows: 


<SegmentA> 
22712024 22712025 ..coordinates.. <from South to North > / 


<Segment B> 
22712025 22710107 ..coordinates..<from South East to North West > / 


<SegmentC> 
22710107 22319045 ..coordinates.. <from South West to North East > / 


These descriptions conform to a directional rule that: 


The first label is name of the zone to the right of the seqment being recorded, and the 
second label is the name of the zone to the left i.e. the direction of digitising is 
clockwise. 


If the direction of digitising is not consistent, segments will be mis-labelled and errors 
willbe generated during processing (see Section 5.5.3.2). 


Recording Short Segments 


When small segments are being recorded there is a possibility that they will collapse 
during processing to form a single node if their lengths are close to the TOLerance 
value. To overcome this problem, short segments should be identified at the time of 
digitising and their end point coordinates entered using the parameter NODES (see 
Section 4.3.1.0). 


4.3.1.3 Interpreting the Output 


Output generated by *FILEIN may be extensive depending on the level of diagnostics 
requested (see Section 4.3.1.1 under DIAGS). If SEGMENT data is being processed and 


the diagnostic level is set to 2 or above, extensive information will be produced about 


each segment, especially if AUTONODE has been selected. For example: 


AUTONODE 

DIAGS = 2 

SEGMENTS 

201 SEA 2618 931 2094 792 2247 988 2436 1025 2480 1107 / 
201 205 2480 1107 2511 1186 2612 1186 / 

201 202 2612 1186 2618 931 / 

Z02 205 2612 1186 2648 1215 / 

Z02. 204 2648 1215 2738 1240 / 

Z02 203 2738 1240 2958 1194 / 

Z02 SEA 2958 1194 2868 1090 3001 1083 2985 1028 2618 931 / 


This example is based on Figure 4.1. 


When processed using *FILEIN , the above input would produce the following 


diagnostic report: 


TYPE COMMAND: SEGMENTS 


SEQUENCE NAMES NODES FIRSTCOORD- LAST COORD PTS 
1 201 SEA 1* 2* 2618 931 2480 1107 5 
2 Z01 Z05 2 3* 2480 1107 2612 1186 3 
3 Z01 Z02 3 1 2612 1186 2618 931 2 
4 Z02 Z05 3 4* 2612 1186 2648 1215 2 
5 Z02 Z04 4 5* 2648 1215 2738 1240 2 
6 202 Z03 9 6* 2738 1240 2958 1194 2 
7 Z02 SEA 6 1 2958 1194 2618 931 5 


The column headed SEQUENCE lists the sequence number of the segments, NAMES 
lists the names of the zones to the right and left of the segment being encoded and 
PTS states the number of points recorded for each segment. 


The columns headed FIRST COORD and LAST COORD list the first and last coordinates 
output to the file after AUTONODE matching has been applied. 


NODES illustrates the autonode system. As GIMMS reads the coordinate data, a Node 
Table is created in which each node is allocated a number. These numbers appear in 
the NODES columns and refer to the node used to match segment start and end points 
respectively. Where an asterisk (*) appears after a node number, it means that a new 
node has been entered into the Node Table. 


For example, when Segment 1 is processed, there are no nodes in the Node Table and 
both start and end points generate new nodes (numbered 1 and 2). When Segment 2 
Is processed however, the start point is matched with the existing Node 2 and only the 
end point creates a new node (numbered 3). When Segment 3 ts then processed, the 
Start point is matched with Node 3 and the end point with Node 1. 


The diagnostic information produced by *FILEIN is extremely useful when used in 
conjunction with the command *CHECK to interpret error in polygon linkage (see 
Section 5). 


4.3.1.4 The Hash System 


In order to deal with large data sets and AUTONODE matching, Node and Centroid 
Tables are stored in a random access file on channel 23. Searching for a node or 
centroid match relies on a geographical ‘hash’ technique. This is based on a grid 
structure where the cell size is calculated as twice the MAXTOL. 


The efficiency of this Hash System is reasonably constant until the space available for 
nodes approaches capacity. At this point, the remaining space is shared and ‘clashes’ 
may result. These become a problem when the ‘number of clashes’ and the ‘length of 
clashes start to increase. Asa result, the processing time required to search for a node 
or centroid match may become unacceptable. 


To avoid excessive processing time, the NODES parameter should be set to a value 
larger than the total number of nodes plus centroids. If it was set to less than this 
number, the command will fail with a warning message. If it is set to just above the 
total, the table will become very full with many clashes and consequent degradation 
in performance. It is therefore recommended that the NODES value be set to 
approximately 3 times the total number of nodes plus centroids. Asa general rule this 
is approximately 9 times the number of polygons being digitised. 


If DIAGS are set to level 2 or above, information about the Hash System is printed 
after the END parameter has been processed and this may be useful in selecting a 
more appropriate value for NODES. 


4.3.1.5 Creating Point and Polygon Files from Data Variables 


The parameters FROMDATA and POLYGRID facilitate the creation of Point files from 
data values and Polygon files from grid centroids. 


In both cases, 2 variables must be selected from the current non-locational DATA file 
to represent coordinate values. 


FROMDATA 
This parameter creates a Point file from two DATA variables. For example: 


*FILEIN 
FILEQUT = 12 TYPE =FROMDATA ZONES = 560 
NAMES = XVALUE, YVALUE 
BEGIN 


This command creates a Point file on channel 12 and coordinates are obtained 
from the DATA variables XVALUE and YVALUE. The parameter ZONES is required 
to indicate the number of points. 


POLYGRID 


This parameter creates a Polygon file and the two variables provide centre points 
for grid cells. For example: 


*FILEIN FILEOUT = 12 TYPE =POLYGRID ZONES = 10000 
NAMES = XVALUE, YVALUE 
RANGE = 20 
BEGIN 


This command creates a polygon file on channel 12 consisting of 10000 
polygons (ZONES) calculated from the centroid values held in the DATA variables 
XVALUE and YVALUE. The parameter RANGE specifies the grid cell size and in 
this example is set to 20 map units. 

A true polygon file is produced by this method, complete with topological links. 
It may therefore be used by the mapping Application Module, *PLOTPROG, to 
generate a variety of statistical maps. 


N.B. POLYGRID may use considerable processing time. 


4.3.2.0 Non-locational Data 


Non-locational data, collected as the result of survey or census, may be entered as a 
NEW file or MERGEd with an existing data file. 


The input of non-locational data relies on a different set of parameters from those 
used with locational data. These parameters are discussed below: 
ZONES, VARS 


The parameter ZONES specifies the number of zones for which data is being 
supplied. For example: 


ZONES = 10 


When used in conjunction with a Polygon file, ZONES must specify the number of 
areas. 


The parameter VARS specifies the number of variables to be read. For example: 
VARS =2 
BASENAME, NAMES 
Data variables may be allocated names in two ways: 


1. The parameter BASENAME can be used to provide a root name and variables 
will then be numbered consecutively. For example: 


VARS = 20 BASENAME =!TEM 
would result in the 20 variables (VARS = 20) being named ITEM1 to ITEM 20. 
The parameter BASENAME is particularly suited to applications involving 
large numbers of variables. 
2. The parameter NAMES may be used to explicitly allocate names to variables. 
For example: 
VARS = 2 NAMES = POP, MANUF 


would result in the first variable being named POP and the second MANUF. 
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N.B. Variable names may be up to 10 characters long, the first of which 
MUST be a letter. 


ABSOLUTE, DENSITY 


Variables may be defined as ABSOLUTE or DENSITY, depending on the values 
they represent. 


ABSOLUTE variables record numbers of observations, such as the number of 
parishes in each county, or the number of new firms created during a given year. 


DENSITY variables record data such as the average size of parishes in each 
county, or the percentage of all new firms in the clothing and footwear industry. 


In short, ABSOLUTE variables are counts of particular attributes within each 


zone, whereas DENSITY variables are summaries, presented in such a way as to 
allow comparison between zones. 


By default, variables are undefined. 


Variables are declared as ABSOLUTE or DENSITY at the same time as they are 
allocated names. For example: 


NAMES = ABSOLUTE,PARISHES DENSITY,AVGESIZE ABSOLUTE,POPN 


declares variables PARISHES and POPN as type ABSOLUTE, and variable AVGESIZE 
as type DENSITY. 


When the keyword DENSITY has been issued, it will remain in force until 
explicitly changed by the keyword ABSOLUTE. 


N.B. \f the parameter BASENAME is used to allocate variable names, there is no 
opportunity to specify or switch between ABSOLUTE or DENSITY and 
variables will remain undefined. 


FORMAT 
When only a portion of the data available are to be read or the data exists in 
fixed format, input may be controlled by a FORMAT statement. Similarly, a 
FORMAT statement may be used to read alpha-numeric characters or to interpret 
data values which are not separated by spaces or commas. 


FORMAT statements follow FORTRAN format conventions and must be 
surrounded by brackets and enclosed by primes. For example: 


FORMAT = '(8F2.0/8F2.0)' 


This FORMAT statement indicates that sixteen variables are spread over two 
lines. Each line contains eight values and each value occupies two columns. 


FORMAT statements must conform to the following rules: 


(a) Only F (numeric) and A (alphabetic) codes are allowed. A codes are of 
the form Al, A2, A3 or A4. 
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(b) The number of variables specified must be matched by the number 
of F and/or A codes. 


(c) The only other codes allowed are X codes and record separators (/). 


FORMAT statements are explained in most FORTRAN language manuals. 


NEW, MERGE, EXTRA 


There are two ways in which DATA and GRID files may be created. The *CREATE 
command may be issued (see Section 9.2.0.0) or the parameter NEW may be 
specified within *FILEIN. 


The parameter NEW has the effect of initialising a new DATA file and 
overwriting existing data. 


If DATAFILE is specified, the data are written to a workfile on channel 21; if 
GRIDFILE is specified the data are written to the workfile on channel 22. 


If the keyword MERGE is specified, data read by *FILEIN are added to an existing 
workfile which is NOT overwritten. In this case however, the data file must have 
been created with sufficient EXTRA space to receive additional variables. This 
extra space may be allocated by the command *CREATE (see Section 9.2.0.0) or 
by explicitly specifying the number of EXTRA slots required. For example: 


EXTRA=5 


would allocate sufficient space to a NEW workfile to allow five extra variables to 
be added at a later stage, over and above those currently being entered. These 
extra variables may be added using a *FILEIN command and the parameter 
MERGE (see Section 4.3.2.3). 


4.3.2.1 Entering Non-locational Data - The Keyword BEGIN 


The parameter BEGIN is again required to initialise data entry. If the parameter FILEIN 
has been issued, data may be read from an external file (see Section 4.3.0.0), otherwise 
it will be read from within the current GIMMS command run. 


The number of values being read should correspond to the number of ZONES 
multiplied by the number of VARS. 


If the parameter MERGE has been used, the number of zones must correspond to 
those in the existing DATA file. 


N.B. After the BEGIN parameter has been issued, only data values should be input and 
no comment statements or GPIS Super Commands may be included. 

Free Format Data Input 

If aFORMAT statement has not been specified, each data value must be separated by 


at least one space or comma. In addition, values which extend beyond column 80 will 
be ignored. 


If insufficient values are specified, the next command will be read and the following 
error message printed: 


ILLEGAL SYMBOLIN DATA 


This message occurs most commonly when one or more values are genuinely missing, 
or when values extend beyond column 80 and appear to be missing. 


It is also possible however, that there may be a genuine ILLEGAL SYMBOL IN DATA, 
perhaps due to the existence of a non-numeric character or a spurious character 
caused by a computer malfunction. These character(s) must be removed as only 
numeric data values can be processed in free format. 


Fixed Format Data Input 


The input of fixed format data is directed by the operating system's FORTRAN 
subsystem and users should be aware that errors may occur outwith the control of 
GIMMS. Both alpha-numeric and numeric data may be read and line length is not 
generally restricted to 80 columns. 


The format of the data must conform to that specified in the FORMAT statement, 
issued prior to the keyword BEGIN (see Section 4.3.2.0 under FORMAT). 


4.3.2.2 Preparation of Non-locational Data 


It is advisable to enter non-locational numeric data in free format as fewer errors are 
likely occur. 


To improve the readability of layout however, it is suggested that data values be 
organised as a series of rows and columns, with rows representing the zones to be 
mapped and columns representing the variables. 


4.3.2.3 Examples of Non-locational Data Input 
The following GIMMS command runs illustrate non-locational data input. 
EXAMPLE 1 

*FILEPARM DATA 'DATAFILE1' GIMMS OUT 


*FILEIN 
DATAFILE ZONES =10 VARS =4 
FILENAME =DATA1 TITLE = ‘Creating a NEW Data file’ 
BEGIN 
01 29.4 342 65.3 
O2 18.6 425 26.4 
03 24.3 534 42.3 
04 16.3 235 33.0 
05 20.5 342 41.7 
06 30.2 403 27.9 
08 27.0 605 30.6 
09 15.4 198 22.5 
10 18.9 302 35.6 
*STOP 


Four variables are read into a new DATA file using free format input. By default, 
the variables will be named V1 to V4. 


EXAMPLE 2 
*FILEPARM DATA 'DATAFILE2’ GIMMS OUT 


*FILEIN 
DATAFILE ZONES = 10 VARS =4 NEW 
FILENAME = DATA2 TITLE = ‘Creating a new Data file’ 
NAMES =SEQNO, MANUF, POP, CARS 
EXTRA = 10 
BEGIN 
0129.4 342 65.3 
O2 18.6 425 26.4 
03 24.3 534 42.3 
04 16.3 235 33.0 
05 20.5 342 41.7 
06 30.2 403 27.9 
08 27.0 605 30.6 
09 15.4198 22.5 
10 18.9 302 35.6 


*STOP 


Four variables are read into a new DATA file using free format input. In this 
example the parameter NEW has been included although this ts the default 
setting. Variables are named SEQNO, MANUF, POP and CARS. An additional 10 
EXTRA vartable slots have been specified. Data may be allocated to these at a 
later stage (see below). 


EXAMPLE 3 
*FILEPARM DATA ‘DATAFILE2’ GIMMS OUTIN 
*FILEIN 
DATAFILE MERGE VARS = 2 


FILENAME = DATA2 TITLE = ‘Adding data to an existing Data file’ 
NAMES = ABSOLUTE, HHLDS DENSITY, CARS2 


Two variables are MERGEd with the existing DATA file created in Example 2. 
These variables are named HHLDS and CARS2 and are declared as types 
ABSOLUTE and DENSITY. 


*FILEPARM 12 ‘DATALIST' TEXT IN 
*FILEPARM DATA ‘DATAFILE3’ GIMMS OUT 


*FILEIN 
DATAFILE ZONES = 10 VARS=5 NEW 
FILENAME =DATA3 
TITLE= ‘Reading data values from external file using FORMAT' 
NAMES = DENSITY, SEQ, MAN 
ABSOLUTE, POP, UNEMP 
DENSITY,CARS 
FILEIN = 12 
FORMAT = '(F2.0,1X,F4.1,2X,F3.1,1X,F4.1,2X,F2.1)' 
BEGIN 


*STOP 
Five variables are read from channel 12 into a new DATA file using a FORMAT 


statement. These variables are named SEQ, MAN, POP, UNEMP and CARS and 
are declared as types ABSOLUTE and DENSITY. 
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5.6.2.1 Removing a Polygon 
5.6.2.2 Adding a Polygon 


5.0.0.0 POLYGON CREATION 


The *POLYGON subsystem processes segment files and creates GIMMS polygon (or 
area) files. Polygon files are required by the mapping Application Module, 
*PLOTPROG, to produce area shaded maps. They are also used by many of the 
routines available in *~MANIPULATE and *UTILITIES (see Sections 8 and 9). 


A GIMMS polygon file consists of a series of zone descriptions, created by linking 
together appropriate segments. The physical area of each polygon and its centre of 
gravity are also calculated and stored. 


5.0.1.0 Commands Available 


Four commands are available to assist in the creation of polygon files: *CHECK, 
*CHECK2, *POLYGON and *POLY2. These commands are controlled by the same 
parameters (see Section 5.1.0.0). 


*CHECK and *CHECK2 are used to verify that segments will join together correctly to 
form polygons. These commands do not generate polygon files but are essential to 
the identification of errors in segment linkage. 


*POLYGON and *POLY2 link segments together to produce polygon files. 


The checking routines in *CHECK and *CHECK2 run significantly faster than polygon 
building routines in *POLYGON and *POLY2. 


The commands *CHECK2/*POLY2 are designed to process larger numbers of polygons 

than *CHECK/POLYGON as they utilise two disc files for storage rather than one. In 

addition, much larger polygons, defined by many points, can be handled by 

*CHECK2/* POLY2. 

N.B. A special version of GIMMS may be set up when the processing capacity of 
*CHECK2 and *POLY2 is exceeded by extremely large data sets. Users should 
consult their local computer advisor. 


Examples of the commands *CHECK and *POLYGON are illustrated in Section 5.3.0.0. 


5.0.2.0 Temporary Files Required for Processing 
In addition to the standard input and output channels, *CHECK and *POLYGON 
require a temporary file in which to store zone descriptions. This file is assigned 
automatically when either of these commands is accessed. 
Should any of the following error messages appear during processing, sufficient space 
has not been allocated to these temporary files or the data space has been badly 
partitioned: 

**** TOO MANY NAMES FOR DATA SPACE 

**** NAME OUT OF RANGE 

**** NO DATA SPACE LEFT 


**** SIZE OF POLYGON TOO LARGE 
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Users may control partitioning within the data space using the parameters ZONES and 
MAXPTS (see Section 5.1.0.0). 


if the error message persists when using *CHECK2 and *POLY2, users should consult 


their local computer advisor as minor changes to the GIMMS software may be required 
to increase the data space. 


5.0.3.0 Controlling Diagnostic Output and Number of Segments 

The volume of diagnostic output produced by *CHECK/*CHECK2 and 
*POLYGON/*POLY2 may be controlled by the command *SYSPARM (see Section 
3.3.1.1 under DIAGS), or by the parameter DIAGS (see Section 5.1.0.0). 

Several levels of diagnostics are available, ranging from 0 (no diagnostics) to 2 (full 
diagnostics). These are discussed in Section 5.2.0.0. The parameter SEGLIST may also 
be used to provide additional information (see Section 5.1.0.0). 


In general, polygons consisting of up to 500 segments may be linked successfully. 
However, if the following error message is reported: 


ZONE... HAS TOO MANY SEGMENTS 


the command *SYSPARM LINKS be used to increase the maximum number of 
segments (see Section 3.3.1.1). 


5.1.0.0 *POLYGON AND *CHECK COMMANDS 


Within the *POLYGON and *CHECK commands the following parameters are 
available: 


FILEIN (IN) (IN 1) [A,REPEAT=20/ specifies input channels for up to 20 
GIMMS segment files 

FILEOUT(AREAFILE) /\/ specifies output channel 

FILENAME /L/ specifies internal name for output file 

USERIN /Ki accesses user subroutine to !nput 
segments 

TITLE (TEXT) /S/ specifies internal title for output file 

XMIN (X1) (LIMITS) A/ specifies minimum X value for sheet 
envelope 

YMIN (¥ 1) /\/ specifies minimum Y value for sheet 
envelope 

XMAX (X2) A/ specifies maximum X value for sheet 
envelope 

YMAX (Y2) /\/ specifies maximum Y value for sheet 
envelope 

NZONES (NUMBER) (NO) = /I, = 1000/ specifies maximum number of zones 

MAXPTS (POINTS) /\, = 1500/ specifies maximum number of points per 
polygon 

USERCODE /\/ specifies value for USERIN subroutine 

DIAGS (D) /\, =(C:SYSPARM)/selects diagnostic level 

REDUCE /R/ specifies toierance value for segment 
reduction 


GAP (TOL) /R/ 
SEGLIST /K/ 
DUPLI /K/ 
INCLUDE (ALL) /K/ 
EXCLUDE /K/ 


ZONE (ZONES) (AREA) (AREAS) (POLYGON) 
/L,REPEAT,K:NZONES/ 


(POLYGONS) 
SEGMENT (SEGMENTS) 
MINZONE (MINLABEL) (LOWEST) — /L/ 
MAXZONE (MAXLABEL) (HIGHEST) /L/ 


ALPHA (ORDER) (SORT) (NAMES) — /K/ 


CULDESAC /K/ 

MINCOL (SELECT) /\/ 

MAXCOL /\/ 

GENERAL [A,REPEAT =9/ 
MASK /SPECIAL/ 


/L,REPEAT, = 10/ 


specifies tolerance value for GAP 
message 

prints segment diagnostic list 

removes duplicate segments (based on 
sequence number) 
includes specified zones 
excludes specified 


segments 


zones and/or 


lists zones to be included or 
excluded from polygon file 

(list of) lists segments to be included or 
excluded from polygon file 

specifies lowest (alphabetic) zone name 
to be included 

specifies highest (alphabetic) zone name 
to be included 

re-orders zones alphabetically prior to 
output 

ignores cul-de-sac segments 

specifies minimum column for zone 
name subset 

specifies maximum column for zone 
name subset 

lists up to 9 generalisation codes 

defines mask for creation of polygon 
names 


Further Notes on *POLYGON and *CHECK Parameters 


FILEIN 


This parameter is used to specify up to 20 input segment files. For example: 


*POLYGON FILEIN = 10, 11, 12... 


would read segment files from channels 10, 11 and 12. 


N.B. When several segment files are specified they should have been recorded 
using a common coordinate system. 


FILEOUT, FILENAME, TITLE 


FILEOUT specifies an output channel number for a polygon file. This channel 
should have been previously assigned by the user using the command *FILEPARM 


(see Section 3.3.1.2). 


FILENAME allocates an internal name to the polygon file, while TITLE can be used 
to document the file in more detail. For example: 


*POLYGON FILEIN= 10, 11,12 FILEOUT = 13 
FILENAME = UK TITLE = ‘UK Regions’ 


The FILENAME may be up to 10 characters long, the first of which MUST be a 
letter The TITLE may be of any length but MUST be enclosed by primes (’’). 


The information stored in the parameters FILENAME and TITLE act as useful 
reminders at a later stage, on the contents of a polygon file and will be printed if 
the file is interrogated using the command *FILEINFO (see Section 3.3.3.4). 


USERIN, USERCODE 


The parameter USERIN is specified when input is not being retrieved from 
GIMMS segments file but from a subroutine provided by the user. This 
subroutine must be called USESEG and users should contact GIMMS Ltd. for a 
description of the interface. 


The parameter USERCODE allows the user to pass an integer value into the 
subroutine. 


For example: 
*POLYGON ... USERIN USERCODE = 3... 
This command accesses the subroutine USESEG and passes in the integer value 3. 
N.B. If USERIN is issued, the parameter LIMITS should also be specified (see 
below). 
LIMITS, XMIN, YMIN, XMAX, YMAX 
By default, values for sheet limits are extracted directly from the input segment 
file(s). Users however, may explicitly specify sheet limits for the output polygon 


file using these parameters. 


The values for LIMITS are used by the mapping Application Module, ~PLOTPROG, 
to automatically scale map outlines (see Section 6.1.3.2). 


NZONES 


This parameter may be used to specify the maximum number of zones for a 
polygon file. By default, the value is set to 1000. 


It is important that the value for NZONES is GREATER than the total number of 


zones being output to the polygon file. If this value is not set high enough, one 
of the following error messages may be reported: 


**** TOO MANY NAMES FOR DATA SPACE 
**** NAME OUT OF RANGE 
N.B. The default number of zones for *POLYGON/* CHECK ts less than the value 


set for *POLY2/*CHECK2. Typical installation defaults are listed in Section 
5.4.0.0. 


MAXPTS 


This parameter may be used to specify the maximum number of points plus 
segments recorded for any one polygon. By default, the value is set to 1500. 


It is important that the value for MAXPTS is GREATER than the total numbers of 
points plus segments. If this value ts not set high enough, the following error 
message may be reported: 


**** SIZE OF POLYGON TOO LARGE 


When MAXPTS is specified, it must be issued prior to the parameters INCLUDE or 
EXCLUDE (see below). If it is not, the following error message will be reported: 


** WARNING ** MAXPTS IGNORED 
N.B. The default maximum number of points for *POLYGON/*CHECK is less 


than the value set for *POLY2/*CHECK2. Typical installation defaults are 
listed in Section 5.4.0.0. 


DIAGS 


This parameter generates diagnostic information and overrides the command 
*SYSPARM DIAGS (see Section 3.3.1.1). 


The value for DIAGS may be set between 0 and 2 and will produce different 
levels of diagnostic information accordingly (see Section 5.2.0.0). 


REDUCE 


GAP 


This parameter may be issued to generalise segments prior to linking and uses 
the method of minimum offset (the Douglas/Peucker algorithm). 


The value for REDUCE ts expressed in map units (i.e. the same units as the 
coordinates in the segment file) and represents the offset. For example: 


REDUCE = 20 


would remove all points within a tolerance distance of 20 map units from the 
general trend of the line. 


This parameter only affects diagnostic information produced by *POLYGON and 
*CHECK. 


If end points of adjacent segments are within the specified GAP value, the 
following message will be printed in preference to the GAP error message 
described in Section 5.5.3.1: 


IN TOLERANCE 


If the gap between segment end points is larger than the specified value 
however, the GAP error message will be reported. 


The value for GAP is expressed in map units. 


SEGLIST 
If this parameter is issued and DIAGS = 1, the diagnostic information produced 
will include alist of the segments within each polygon (see Section 5.2.0.0). 
INCLUDE, ALL, EXCLUDE, ZONE, SEGMENT 
These parameters are used to explicitly select which zones are to be checked or 
output to a polygon file. They may be combined in four ways: 
(1) INCLUDE or INCLUDE ALL 


- all zones will be included. This is the default setting. 


(ii) INCLUDE ZONES namei, named, etc. 
- only those zones referred to by name will be included. These zones 
will be output in the same order as they appear in the INCLUDE ZONES 
list unless the parameter ALPHA has been specified (see below). 


INCLUDE ZONES provides a means to check specific zones. For 
example. 


*CHECK FILEIN = 11, INCLUDE ZONES AQ1BJAC, A01BCBM 
would only apply checking routines to zones AQ1BJAC and A01BCBM. 
N.B. Methods (ii) and (il!) are mutually exclusive and cannot be used within the 
same *POLYGOWN/ *CHECK command. 
(111) EXCLUDE ZONES namel, name2, etc. 
excludes those zones referred to by name. Up to 50 zones may be 


excluded by this method. 


N.B. Methods (ii) and (ii!) are mutually exclusive and cannot be used within the 
same *POLYGON/ *CHECK command. 


(iv) EXCLUDE SEGMENTS namel, name2, etc. 


- those segments referred to name will be excluded. Any segment 
labelled with one of the names appearing in the EXCLUDE SEGMENTS 
list will be COMPLETELY IGNORED on input. A maximum of 10 
segments may be excluded tn this way. 
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When a study area is digitised from several map sheets, EXCLUDE 
SEGMENTS may be used to ignore sheet edges. Each sheet can then be 
topologically checked in turn. 


N.B. EXCLUDE SEGMENTS is independent of methods (i), (ii) and (iii) and may be 
used together with any of the above. 


Further examples of INCLUDE and EXCLUDE are given in Section 5.3.0.0. 


MINZONE, MAXZONE 


These parameters may be used to select a range of valid zone names. For 
example: 


MINZONE = CD5742, MAXZONE = CD8314 
selects zone names between CD5742 and CD8314 inclusive. 


N.B. These parameters use alphanumeric comparisons and NOT numeric. 


ALPHA 


This parameter will reorder zones alphabetically by name prior to printing 
diagnostics or generating polygons. 


ALPHA is an extremely useful parameter in controlling the order in which 
polygons are stored. The user MUST be aware of this order before allocating 
non-locational data values for mapping. 


N.B. The order in which non-locational data values are input MUST match the 
order in which polygons are stored and plotted. If they do not match, 
GIMMS will allocate data to the wrong zones. 


CULDESAC 


A cul-de-sac is defined as a segment which has the same zone name on either 
side. 


If this parameter is selected, cul-de-sacs will be ignored when segment files are 
Input. 


CULDESAC is generally used together with MINCOL and MAXCOL or MASK (see 
below). 

MINCOL, MAXCOL 
These parameters are used to subset segments recorded on the basis of a 
hierarchial labelling system (see Section 4.3.1.1 under SEGMENTS). They are 
generally used together with CULDESAC to extract different polygon layers. 


For example, the label AO1ACBG may refer to. three layers in a segment 
hierarchy: 


A0N1, AQ1AC, A01ACBG 
To extract the second layer, the following command would be required: 
MINCOL = 1, MAXCOL = 5 CULDESAC 


Labels AO1ACBG and AQIACAY will be reduced to AO1AC. Any segment 
referenced by these labels would be considered a CULDESAC as it would have the 
same label on both sides. It would therefore be ignored and would not be 
included in the polygon file. 


N.B. Labels extracted using MINCOL and MAXCOL must constitute valid zone 
namesi.e. they MUST begin with a letter. In the above example, specifying 


MINCOL = 2, and MAXCOL = 5 would be unacceptable as the resulting label 
(01ACBG) would not begin with a letter. 


MASK 
The parameters MINCOL and MAXCOL can be used to control the way in which 
names are allocated to polygons. For example, the general format of a zone 


name may be as follows: 


RCCDD - where R is a letter indicating Region; CC are numbers indicating 
County; and DD are numbers indicating District 


The command: 
*POLYGON ... MINCOL = 1,MAXCOL = 3 CULDESAC 


would select columns 1,2 and 3 from the zone name and produce a polygon file 
for Counties. Asegment coded A11214 would be recoded A111. 


If a polygon file was to be produced for Districts and each District was referenced 
by a unique number across Counties and Regions, it would be reasonable to 
assume that the following command was required: 


*POLYGON ... MINCOL= 4, MAXCOL = 6 CULDESAC 


But this would NOT be the case as resulting polygon names would not begin with 
a letter. 


The parameter MASK however, may be used to insert arbitrary text. For 
example: 


*POLYGON ... MASK = 'DIST', 4, 5,6 CULDESAC 
Using this command, asegment labelled A11214 would be recoded as DIST214. 


Text and column numbers may be mixed in any combination to produce zone 
names. For example: 


MASK = ‘D',4, 1, 'T', 6 


would produce zone names beginning with the letter D, followed by the 
characters stored in positions 4 and 1 in the segment label, the letter T and the 
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character stored in position 6. The label A11214 would therefore be recoded as 
D2AT4. 


GENERAL 


This parameter may be used to attach generalisation codes to the coordinates 
recorded in a polygon file. These codes can then be used at a later stage by the 
commands *~DRAWMAP and *GIMMSFILE to plot map outlines with varying 
degrees of generalisation (see Section 6.1.3.2). 


A maximum of 9 generalisation codes may be specified within *POLYGON. For 
example: 


*POLYGON 


GENERAL = 50, 40, 35, 30, 25, 20, 15, 10,5 


This command defines 9 levels of generalisation. The generalisation code for the 
first (largest) value is 1. The generalisation code for the last (lowest) value is 9. 
When a map is produced using *DRAWMAP, and a generalisation code is 
specified, e.g. GENERAL= 4, only those points with code level 4 or less will be 
plotted. 


GENERAL = 1 plots the most detailed outlines while GENERAL = 9 plots the most 
generalised outlines. 


The Douglas/Peucker algorithm is used to calculate generalisation levels. Those 
points falling outside the specified offset value are allocated the value of the 
current generalisation test. Offset values are expressed in map units and should 
be presented in descending numerical order. 


The Douglas/Peucker algorithm and GENERAL operate in the following way. For 
each segment an imaginary straight line is drawn joining the end points. The 
point in the segment furthest from this line is located and tested against the first 
(largest) offset value. If the point is a greater distance from the line than the 
specified value, it is declared ‘significant’ and the generalisation code 1 is 
attached to it. If the distance from the line is less than the first offset value the 
next, slightly smaller, value is tested in the same way. This process continues 
until either all the offset values are tested against the point or the point is found 
to be significant. 


When a point is defined as ‘significant the segment is effectively split into two. 
The generalisation process then continues for each part separately. Whenever 
significant points are located, each sub-section of the segment is divided at that 
point, and each part processed individually. 


DUPLI 


This parameter is used to remove duplicate segments recorded with the same 
sequence number (see Section 4.3.1.1). For example, when a large study area 
comprised of several regions, is being digitised, segment files may relate to each 
region. These files will contain duplicate segments along region boundaries 
which will be allocated the SAME sequence numbers. Polygon files for groups of 


> Baal, 


regions may be produced from these segment files and the parameter DUPLI 


used to 


remove segment duplicates. 


5.2.0.0 DIAGNOSTIC OUTPUT 


*POLYGON and *CHECK output three levels of diagnostic information. These 
correspond to DIAGS values of 0, 1, and 2. 


DIAGS = 0 
DIAGS = 1 
DIAGS = 2 


Examples of 
iustrated in 


generates no diagnostic information. 


for each polygon includes zone name, number of segments, area 
measurement, centroid coordinate, and number of islands and cul-de- 
sacs. 


for each polygon includes zone name, number of segments, area 
measurement, centroid coordinate, the number of islands and cul-de-sacs 
together with a list of segments, their start/end points and the number 
of points recorded for each segment. The area description ts also 
expanded to include the start and end points of each segment. 


Notes 


i) If DIAGS= 1 and the parameter SEGLIST is specified, additional 
diagnostic information will be produced and, although area 
description remain compacted, the list of segments will be printed 
as though DIAGS = 2. 


li) {f a zone is in error the diagnostics for that zone will be 
automatically printed at level 2. 


iii) Area measurements and centroid coordinates of resulting 


polygons are only calculated by *POLYGON and not by *CHECK. 


*POLYGON/* CHECK and associated diagnostic output are described and 
Sections 5.5.0.0 to 5.5.3.5. 


5.3.0.0 EXAMPLES OF *CHECK AND *POLYGON 


The following examples illustrate the use of *CHECK and *POLYGON. Input and 
output files have been previously assigned by the user using the command *FILEPARM 
(see Section 3.3.1.2). 


Example 1 


*CHECK FILEIN=10 ALPHA 


*CHECK <to topologically check segment file > 
FILEIN = 10 <segment file will be read from channel 10> 
ALPHA <zones checked will be listed alphabetically in the diagnostic 


output > 
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Example 2 


*CHECK FILEIN=10 DIAGS =2 ALPHA 


*CHECK <to topologically check segment file > 
FILEIN = 10 <segment file will be read from channel 10> 
DIAGS = 2 <selects level 2 diagnostics > 
ALPHA < zones checked will be listed alphabetically in the diagnostic 
output > 
Example 3 


*CHECK FILEIN = 10 INCLUDE ZONES = A0Q1BJAC, A01BCBM 


*CHECK 
FILEIN = 10 


INCLUDE ZONES = 


Example 4 


<to topologically check segment file > 
<segment file will be read from channel 10> 


<only those zones and *POLY2/*CHECK2 > 


*POLYGON FILEIN=10 FILEOUT=12 FILENAME =TEST 
TITLE = ‘Test area file’ 


DIAGS = 2 ALPHA EXCLUDE ZONE = OUT 


*PLOYGON 
FILEIN = 10 
FILEQUT = 12 
FILENAME = 
TITLE S33... 
DIAGS = 2 
ALPHA 


EXCLUDE ZONE = 


<to create a polygon file> 

<segment file will read from channel 10> 

< polygon file willbe output to channel 12> 
<assigns an internal name to the polygon file> 
< assigns an internal title to the polygon file> 
<selects level 2 diagnostics > 

<polygons will be stored in alphabetical order > 


<excludes named zones from polygon file > 
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Example 5 


*POLYGON FILEIN=10,11 FILEOQUT =12 FILENAME = TEST DIAGS =2 
TITLE = ‘Reduced and generalised area file’ 
REDUCE =5 INCLUDE ZONES = CD134, CD137, CD156, CD172 
GENERAL = 100, 50, 20, 15, 10 


*POLYGON <to create a polygon file> 

FILEIN = 10,11 <segment files will be read from channels 10 and 11> 
FILEOUT = 12 < polygon file will be output to channel 12> 
FILENAME = < assigns an internal name to the polygon file > 
DIAGS = 2 <selects level 2 diagnostics > 

VLE Se 3 <assigns an internal title to the polygon file > 
REDUCE = <reduces segment input by specified band width > 


INCLUDE ZONES= <only those zones specified by name will be included in the 
polygon file> 


GENERAL = <attaches generalisation codes to segments > 


5.4.0.0 LIMITATIONS OF *POLYGON/*CHECK 


Limitations are imposed on *POLYGON/*CHECK because of the requirement to store 
large volumes of date. Some of these limitations relate to data files while others are 
due to programming restrictions. 


Limitations related to data files include: 


(a) number of zones output (see Section 5.1.0.0 under NZONES) 

(b) maximum number of points per polygon (see Section 5.1.0.0 under 
MAXPTS) 

(c) space requirements for segment data 


Limitations related to programming restrictions include: 


(d) number of points per segment 

(e) number of segments per zone (see Section 3.3.1.1 under LINKS) 
(f) number of labels per segment (maximum is 30) 

(g) other space requirements not covered by (a), (b) and (c) above. 


Limitations for (a), (b) and (c) above vary between *POLYGON/*CHECK and 
*POLY2/*CHECK2. Typical values are as follows: 


Restriction *POLYGON!/ *CHECK *POLY2/ *CHECK2 
(a) number of zones output 1000 5000 
(b) maximum number of points per polygon 1500 10000 
(c) segment data/no. of straightsegments 1300 (approx) 25000 (approx) 
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N.B. Parameters NZONES and MAXPTS may be used increase values for 
*POLYGON/* CHECK (see Section 5.1.0.0). 


Some of these limitations may be modified by making alterations to the GIMMS 
software. Further details are available from GIMMS Ltd. 


9.5.0.0 eee CREATION AND INTERPRETATION OF DIAGNOSTIC 
TPUT 


The *POLYGON/* CHECK subsystem is complex and generates diagnostic output which 
requires careful interpretation. This section describes the processes involved in 
polygon creation and illustrates some of the more common errors which may occur 
from digitising. 


5.5.1.0 The Process of Polygon Creation 


Creating a polygon from a series of segments is conceptually simple. All that is 
required 1s to link the segments in order around the polygon. In practice, however the 
process is complicated by errors occurring during digitising. 


In processing digitised data, GIMMS reads and stores each segment from the input 
file(s) in turn. At the same time, a list of zone names is also created and a diagnostic 
segment list is printed. 


Segments referenced by the same zone names are collected together and linked to 
form polygons. If the *POLYGON command has been issued, diagnostics are also 
printed for individual polygons. 


There are two stages in linking segments. Firstly, to ensure that the appropriate label 
appears first, segments may be automatically reversed. For example: 


201 202 2612 1186 2618 931/ 


When this segment is processed to create zone Z01, no reversal will take place as 201 Is 
the first label. However, when creating zone 202, the segment is reversed. This 
would be equivalent to recording the segment as: 


Z02 201 2618 931 2612 1186/ 


N.B. In the accompanying diagnostic output, segment reversal is indicated by the 
symbol (R) (see Section 5.5.2.0). 


In the second stage of segment linking, the end point of one segment is joined to the 
start point of another. This procedure is repeated until all the seqments for a 
particular zone have been linked. The end point of the final segment should then 
match the start point of the first. 


In practice, linking segments together to form polygons may generate a number of 
errors, largely related to digitising. The most common results when the end point of 
one segment cannot be matched to the start point of the next. The following error 
message will be printed in the diagnostic output: 


kkk GAP kkk 


e 


If the polygon concerned is plotted, the gap will be drawn as a straight line. 


Shs 


A special form of gap occurs when the end point of the final segment does not match 
the start point of the first segment. In effect the list of seqments does not form a 
closed loop and tn this case, the error message will read: 


**** LAST POINT DOES NOT CLOSE ISLAND **** 


In many situations, complex polygons with more than one extent will be recorded. 
These will often exist as zones divided into different parts, such as mainland with 
offshore islands, or as a zone witha ‘hole’ to record the existence of a lake etc. When 
one segment is linked to the next, the end point of the second segment is checked 
against the start point of the current extent and if it matches then that is recognised as 
the end of that extent. The beginning and end segments are labelled with the ‘START 
SEGMENT’ and ‘END SEGMENT’ messages respectively. 


A special form of extent is a single segment island or hole. In this case, one segment is 
used to describe the a complete extent and coordinates for the start and end points 
are the same. This situation is identified by the message: 


ISLAND/HOLE 


It should be noted that the process of identifying the order in which to link segments 
to form polygons uses only zone names and the coordinates for segment start and end 
points. Using this method to create polygons ensures that if they have been linked 
correctly and there are no errors, the resulting polygon file is COMPLETE, CONSISTENT, 
and CORRECT as far as the topological linking process is concerned. Although there 
may still be errors on the file such as incorrect coordinates or names not beginning 
with a letter, these are not relevant to the process of linking segments. 


5.5.2.0 Interpreting Diagnostic Output 
The following examples are based on Figure 4.1 and illustrate diagnostic output from 
the *CHECK subsystem. To reduce the volume of diagnostic output produced only two 


zones, Z01 and 202, have been *CHECKed. 


Several errors will also be tntroduced to highlight common problems arising during 
processing. 


Zones 201 and Z02 are described in Section 4.1.1.0 by the following segment input: 


*FILEIN FILEOUT = 10 


SEGMENTS 

ZO01 SEA 2618 931 2094 792 2247 988 2436 1025 2480 1107 / 
ZO1 205 2480 1107 2511 1186 2612 1186 / 

Z01 202 2612 1186 2618 931 / 

ZO02 205 2612 1186 2648 1215 / 

Z02 204 2648 1215 2738 1240 / 

ZO02 203 2738 1240 2958 1194 / 

202 SEA 2958 1194 2868 1090 3001 1083 2985 1028 2618 931 / 
END 
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The diagnostic output generated by the examples in this section have been produced 
using the command: 


*CHECK FILEIN = 10, INCLUDE ZONES 201, 202 DIAGS = 2 * 


When the above segment input is processed using this command the following 


diagnostic information is generated: 


1 Z01 SEA 2618 931 2480 1107 5 PTS 
2 201 205 2480 1107 2612 1186 3 PTS 
3 Z01 202 2612 1186 2618 931 2PTS 
4 Z02 205 2612 1186 2648 1215 2PTS 
5 202 204 £2648 1215 2738 1240 2PTS 
6 Z02 203 2/738 1240 2958 1194 2PTS 
7 ZO2 SEA 2958 1194 2618 931 5 PTS 
NO. OF INPUT POINTS = 21 

POLYGON = Z01 SEGMENTS = 3 


ENVELOPE (MIN X,Y : MAX X,Y) : 2094 792 2618 1186 


SEA 2618 931 2480 1107 1 #+2=+1 START SEGMENT 
205 2480 1107 2612 1186 2. 2 
Z02 2612 1186 2618 931 3 3 ENDSEGMENT 


POLYGON = 202 SEGMENTS = 5 
ENVELOPE (MIN X,Y : MAX X,Y) : 2612 931 3001 1240 


201 2618 931 2612 1186 1 3 START SEGMENT (R) 
Z05 2612 1186 2648 1215 2 4 

Z04 2648 1215 2738 1240 3 #5 

203 2738 1240 2958 1194 4 6 

SEA 2958 1194 2618 931 5 7 END SEGMENT 


ZONES CHECKED = 2 


In this example, no errors have been reported and polygons 201 and Z02 are therefore 
complete. 


Diagnostic information consists of two parts: 
1. Segment List 


The Segment List is produced as the input file(s) is being read. Only those 
segments INCLUDEd in the *CHECK command will be listed. 


Each segment ts described in the Segment List as follows (for examples refer to 
diagnostic output above): 


) Sequence number of segment e.g. 1 

List of zone names referencing segment e.g. Z01 SEA 
Start point of segment e.g. 2618 931 

) End point of seegmente.g. 2480 1107 

) Number of points recorded for segment e.g. 5 PTS 


gg, gin, 
RANnTeH 


2. Zone Diagnostics 


Each zone is described as follows: 


a= 15 


(a) Zone or polygon name e.g. 201 
(b) Number of segments e.g. SEGMENTS = 3 


(c) Zone or polygon envelope (i.e. enclosing rectangle) 
e.g. ENVELOPE (MIN X,Y : MAX X,Y) : 2094 792 2618 1186 


In addition, each linked segment is described as follows: 


(d) Name of zone on other side e.g. SEA 
(e) Start point of seqment e.g. 2618 931 


Tao => 


} 


Pete ae ae a ce 
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End point of segment e.g. 2480 1107 

) Link sequence number e.g. 1 

) Sequence number of segment e.g. 1 
Message/description e.g. START SEGMENT or END SEGMENT 
Segment Reversal indicator t.e. (R) 


If a polygon file is being created using the command *POLYGON, the following 
information is supplied for each zone: 


(k) Calculated area for polygon 
(1) Calculated centroid for polygon (i.e. centre of gravity) 


Information will also be printed, where appropriate, relating to the number of 
extents (i.e. islands or holes), and generalisation codes. 


Additional Notes 


i) 


i1) 


lil) 


Sequence number (h) is generated by the command *FILEIN and has the 
same value as sequence number (a) in the Segment List. 


The link sequence number (g) Is allocated to polygon segments prior to 
linking. The initial value is 1 and it is augmented by 1 each time a 
segment is read. For example, if there were 5 segments, the link 
sequence numbers would run from 1 to 5. This number remains 
attached to the segment during processing and indicates the order of 
linkage. 


In the above example, the link sequence number for segments in 
polygon Z01 is 1, 2, 3. This indicates that the first segment located for 
that polygon was linked to the second segment, which in turn, was 
linked to the third segment. The third segment would then be linked 
back to the first. 


The procedure of segment reversal is described in Section 5.5.1.0. In the 
above example, segment reversal occurs for Z02/Z01 and is indicated by 
the symbol (R). 


In the Zone Diagnostics for polygon Z01, no reversal indicator is 
opposite zone name Z02. The segment start and end points are 
therefore the same as those recorded in the Segment List (i.e. 2612 1186 
2618 931). In the Zone Diagnostics for polygon Z02 however, the 
reversal indicator (R) appears opposite zone name Z01. The segment 
start and end points are therefore reversed relative to the Segment List 
(i.e. 2618 931 2612 1186). It is therefore implied that the segment 
between these two polygons was digitised as 201/202 and not as 
202/201 
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5.5.3.0 Errors in Linking Segments 


Many errors can occur in digitising and some of the more common problems are 
illustrated below. These include: 


- Missing segments 

- Mislabelling segments 

- Overshooting/concatenation of segments 
- Segments collapsing 


Some errors may be relatively simple to diagnose and correct. More complex errors 
however, may be investigated using the interactive editor, *EDIT (see Section 5.6.0.0). 


5.5.3.1 Missing Segments 


By removing segment Z01/Z05 from the segment input listed in Section 5.5.2.0, an 
error results in processing. This affects zone Z01 and generates the following Zone 
Diagnostics: 


POLYGON = 201 SEGMENTS = 2 

BOUNDARY NOT CLOSED! 

kakk kk kkk kkk ERRORIN AREA DESCRIPTION Kaa Ke aKa K KKK 
ENVELOPE (MIN X,Y : MAX X,Y) : 2094 792 2618 1186 

SEA 2618 931 2480 1107 1 #1 START SEGMENT 
ZQ2 2612 1186 2618 931 2 2 **** GAP **** 


POLYGON = 202 SEGMENTS = 5 

ENVELOPE (MIN X,Y : MAX X,Y) : 2612 931 3001 1240 

Z01 2618 931 2612 1186 1 3 START SEGMENT (R) 
Z05 2612 1186 2648 1215 2 4 
Z04 2648 1215 2738 1240 3 £5 
203 27/38 1240 2958 1194 4 6 
SEA 2958 1194 2618 931 5 7 ENDSEGMENT 


**** ZONES WITH ERRORS = 1 
ZONES CHECKED = 2 


During processing, it is recognised that the description of zone Z01 Is incomplete and 
the following error message is output: 


kkkk GAP kkk 


This message indicates that a gap exists between the segment, 202 and the PREVIOUS 
segment, SEA. By examining the map used in digitising (see Figure 4.1) and 
comparing the zones bounding polygon Z01 with those referred to in the Zone 
Diagnostics, it becomes evident that segment 201/205 is missing. 


To correct this error, coordinates for segment Z01/Z05 should be added to the segment 
input and the *FILEIN/* CHECK process repeated. 


N.B. The GAP error message overrides any other Zone Diagnostic messages, such as 
END SEGMENT. 


pom i, 


In some cases, a GAP message may not indicate a missing segment but an actual gap 
between the end point of one segment and the start point of the next. This situation 
usually occurs when an incorrect TOLerance value has been specified during *FILEIN 
(see Section 4.3.1.0). Selecting a higher TOLerance value will often solve the problem 
but users should also refer to Section 5.3.3.4. 


To give a further example of the effect of missing segments, segment Z01/Z02 has also 
been removed. This time, both polygons Z01 and 202 are affected and the Zone 
Diagnostics produced are as follows: 


POLYGON = 201 SEGMENTS = 1 

BOUNDARY NOT CLOSED! 

kak kkk kK KKK FRROR IN AREA DESCRIPTION wKaKKKKkKKk Kk KKK 
ENVELOPE (MIN X,Y : MAX X,Y) : 2612 931 2618 1107 

SEA 2618 931 2480 1107 1 #=71 ONLY SEGMENT 
**** | AST POINT DOES NOT CLOSE ISLAND **** 


POLYGON = 202 SEGMENTS = 4 

BOUNDARY NOT CLOSED! 

waka aKa KK Kaka Kk FRRORIN AREA DESCRIPTION ************ 
ENVELOPE (MIN X,Y : MAX X,Y) : 2612 931 3001 1240 

ZO5 2612 1186 2648 1215 1 2 START SEGMENT 
204 2648 1215 2738 1240 2. 3 

203 2738 1240 2959 1194 3 4 

SEA 2958 1194 2618 931 4 5 ENDSEGMENT 
**** LAST POINT DOES NOT CLOSE ISLAND **** 


**** ZONES WITH ERRORS = 2 
ZONES CHECKED = 2 


Processing correctly identifies that both polygons are incomplete. In particular, both 
polygons generate the error message: 


**** LAST POINT DOES NOT CLOSE ISLAND **** 


This is a special form of the GAP message and indicate that the gap exists between the 
last and first segments. In addition, polygon 201 now consists of only one segment 
(Z01/SEA) and, as start and end points are not the same, the polygon does not close. It 
does not therefore represent an ‘island/hole’ and is accompanied by the error 
message’ 


ONLY SEGMENT 
5.5.3.2 Mislabelling Segments 
A common fault when digitising is mislabelling a segment by recording it in the wrong 
direction. The direction of digitising may be clockwise or anticlockwise but MUST be 
consistent (see Section 4.3.1.2). For example, when digitising in a clockwise direction, 
the segment should be labelled so that the first name represents the zone to the right, 


while the second name represents the zone to the left. 


An error of this type may be generated by reversing the coordinates for segment 
201/Z02 inthe original data input. For example: 


Z01Z02 26)2 1186 2618 931 / 
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becomes: 
201 202 2618 931 2612 1186 / 


The diagnostic output produced from processing this data is as follows: 


POLYGON = 201 SEGMENTS = 3 

BOUNDARY NOT CLOSED! 

kKaekkk kkk kkk k ERRORIN AREA DESCRIPTION ************ 
ENVELOPE (MIN X,Y : MAX X,Y) : 2094 792 2618 1186 

SEA 2618 931 2480 1107 1 #+=1 = START SEGMENT 
ZQ5 2480 1107 2612 1186 2 2 

Z02 2618 931 2612 1186 3 3 **** GAP**** 
**** LAST POINT DOES NOT CLOSE ISLAND **** 


POLYGON = 202) SEGMENTS = 5 

BOUNDARY NOT-CLOSED! 

Keak kk kek Kk aK ERRORIN AREA DESCRIPTION ****** ****** 
ENVELOPE (MIN X,Y : MAX X,Y) : 2612 931 3001 1240 

201 2612 1186 2618 931 1 #3 START SEGMENT (R) 
Z05 2612 1186 2648 1215 2 4 **** GAP **** 
Z04 2648 1215 2738 1240 3 #5 

Z03 2738 1240 2958 1194 4 6 

SEA 2958 1194 2618 931 5 7 ENDSEGMENT 
**** LAST POINT DOES NOT CLOSE ISLAND **** 


**** ZONES WITH ERRORS = 2 
ZONES CHECKED = 2 


This type of error may generate several messages. When the original map used in 
digitising is examined (see Figure 4.1), it appears that all the segments are present and 
in the Zone Diagnostics they are listed in the correct order. However, on inspecting 
the Zone Diagnostics further it may be noted that some coordinates appear twice in 
the same column. For example, in polygon 201, the coordinate 2618,931 appears 
twice in the ‘Start Point of Segment’ column. Thisis a VERY strong indication that one 
or more segments have been mislabelled. Since both polygons appear to display the 
same problem, there is a high probability that the segment common to both (i.e. 
Z01/Z02) ts in error. 


Reversing segment labels OR coordinates (but not both) in the original data input and 
repeating the *FILEIN/* CHECK process should correct the error. 
5.5.3.3 Overshooting/ Concatenation of Segments 


When digitising, it is relatively easy to ‘overshoot’ the end of a segment and continue 
to digitise along the next segment by mistake. 


This type of error will affect the two zones sharing the common segment. To illustrate 
this situation, segments Z01/Z05 and 201/202 have been concatenated in the orginal 
data input: 


201 205 2480 1107 2511 1186 2611 1186/ 
Z01 Z02 2612 1186 2618 931/ 


becomes. 
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201 205 2480 1107 2511 1186 2612 1186 2618 931 / 
The Zone Diagnostics produced from processing this data is as follows: 


POLYGON = 201 SEGMENTS = 2 

ENVELOPE (MIN X,Y : MAX X,Y) : 2094 792 2618 1186 

SEA 2618 931 2480 1107 1 #1 START SEGMENT 
Z05 2480 1107 2618 931 2 2 ENDSEGMENT 


POLYGON = 202 SEGMENTS = 4 

BOUNDARY NOT CLOSED! 

kaekkk kkk kkk k ERROR IN AREA DESCRIPTION ************ 
ENVELOPE (MIN X,Y : MAX X,Y) : 2612 931 3001 1240 

Z05 2612 1186 2648 1215 1 3 START SEGMENT 
204 2648 1215 2738 1240 2 4 

203 2738 1240 2958 1194 3 5 

SEA 2958 1194 2618 931 4 6 END SEGMENT 
**** LAST POINT DOES NOT CLOSE ISLAND **** 


**** ZONES WITH ERRORS = 1 
ZONES CHECKED = 2 


When the original map is examined (see Figure 4.1) to find the error in Z02 and 
compared with the Zone Diagnostics, it is apparent that segment Z01/Z02 Is missing. 
This has resulted in the error message: 


LAST POINT DOES NOT CLOSE ISLAND 


As polygon 201 has closed successfully however, this is a VERY strong indication that 
segments have been concatenated. Although it may appear that the complete 
boundary for 201 has been digitised, it is evident from the map that names or all the 
surrounding zones are not present. 


Splitting the segment 201/ 205, or redigitising the two segments, and repeating the 
*FILEIN/* CHECK will correct the error. 


5.5.3.4 Collapsed Segments 


This type of error will occur when the TOLerance value is too high and short segments 
‘collapse’ to single nodes (see Section 4.3.1.2). To illustrate this situation the 
beginning and end points of segments 202/205 and 202/204 have been moved to the 
‘node representing the end point of segment 201/205. 


The Zone Diagnostics produced from processing this data are as follows: 


POLYGON = Z02 SEGMENTS = 5 

ZONE HAS 2 EXTENTS (I.E. ISLANDS OR HOLES) 

ENVELOPE (MIN X,Y : MAX X,Y) : 2612 931 3001 1240 

201 2618 931 2612 1186 1 3 START SEGMENT (R) 
Z04 2612 1186 2738 1240 3 5 
Z03 2738 1240 2958 1194 4 6 
SEA 2958 1194 2618 931 5 7 ENDSEGMENT 


Z05 2612 1186 2612 1186 


RO 
pa 


ISLAND/HOLE 


Although this polygon is regarded as being topologically correct, the ‘collapsed’ 
segment Z02/Z05 has been moved to the end of the list and designated as an 
ISLAND/HOLE. The existence of this feature when such an object does not exist on the 
Original map is a VERY strong indication that a segment has collapsed. 


This error can be corrected by resetting the TOLerance to a smaller value and 
repeating the *FILEIN/*CHECK process. 


5.5.3.5 Compound Errors 


The examples above illustrate several common errors and indicate how these may be 
corrected. In practice, correcting errors resulting from digitising can be extremely 
frustrating and time-consuming. In addition, errors in one polygon may result in 
errors in another and detecting the fault can be difficult. The interactive editing 
facility may help determine some of the more complex errors and incorporates a 
number of commands to correct segment input (see Section 5.6.0.0). 


5.6.0.0 THE *EDIT SUBSYSTEM 


The *EDIT subsystem provides an interactive editing facility designed to investigate 
and correct errors occurring in GIMMS segment files prior to polygon creation. It 
overcomes many of the difficulties in trying to interpret the diagnostic output 
generated by *CHECK, as segments in error can be selectively displayed on a graphic 
screen. 


Input to *EDIT is in the form of a GIMMS segment file, previously been created using 
*FILEIN (see Section 4). Output from *EDIT is in the form of a new GIMMS segment 
file. This output file may be further processed to create polygons using the command 
*POLYGON (see Section 5.1.0.0). 


N.B. As *EDIT provides an interactive editing facility and makes use of the graphic 
cursor, users should refer to Section 2.2.3.2. 


*EDIT has many parameters in common with *POLYGON/*CHECK. For example: 
*EDIT FILEIN = 11, FILEOUT = 12, NZONES = 1200 / 


In addition, *EDIT incorporates its own set of unique commands and these may be 
considered under several headings: 


1. System Commands 
END Terminates editing session and saves results to an output segment 
file 
QUIT Aborts editing session t.e. changes will NOT be saved 
SAVE Saves changes and returns to editing 


N.B. 


Selection Commands 
SELECT Selects one or more zones for editing 
EXCLUDE Excludes selected zone from plotting or printing 


Drawing Commands 


DRAW Plots selected segments on graphic screen 
ZOOM Windows in and out from graphic screen image 
GRID Plots grid on graphic screen 


Editing Commands 

JOIN Joins asegment to a node 
REMOVE Removes a segment 

RENAME Renames a segment 

SPLIT Splits segment at a specified point 


NEWNODE- Creates anew node 


DUPLI Removes duplicate segments 
ADD Adds anew segment by digitising from screen 
UPDATE Aborts or forces updates 


Information Commands 


PRINT Prints list of seqments currently selected 
LINK Topologically links selected zone 
IDENTIFY Identifies nodes or segments using graphic cursor 


Values for the following commands are generally specified using the graphic 
cursor: 


JOIN, SPLIT, NEWNODE, ADD, IDENTIFY, Z00M 


5.6.0.1 The Editing Process 


*EDIT is accessed from the *UTILITIES Application Module (see Section 9) 


When an existing segment file has been read by *EDIT, individual segments may be 
selected from the file using the command SELECT. A variety of editing procedures are 
available to correct errors generated from digitising. Common editing operations 
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include JOINing end points of segments to nodes, and RENAMEing,  SPLITing, 
REMOVEing and ADDing segments. 


When editing is complete, the session is terminated by the command END. Results will 
then be stored in an output segment file and control return to the *UTILITIES 
Application Module. 
The new GIMMS segment file generated as the result of an editing session, may be 
further processed to create a polygon file using the command *POLYGON (see Section 
5.1.0.0. Alternatively, it can be used in conjunction with the command *FILEDUMP to 
generate a character file (see Section 9.4.0.0). 
5.6.0.2 Accessing the *EDIT Subsystem 
The following commands are required to access the “EDIT subsystem: 

*FILEPARM 11 'OLDSEGMENTS' GIMMS 

*FILEPARM 12 NEWSEGMENTS' GIMMS 

*PLOTPARM T4107 NOLOGO 

*UTILITIES 


*EDIT FILEIN=11 FILEOUT =12/ 


These commands are described below. 


*FILEPARM 11 ‘OLDSEGMENTS’ GIMMS 


This command assigns an existing GIMMS segment file to channel 11. 


*FILEPARM 12 ‘NEWSEGMENTS' GIMMS 


This command assigns a GIMMS file to channel 12. This file will store the new 
GIMMS segment file created as a result of the current editing session. 


N.B. The command *FILEPARM Is fully described in Section 3.3.1.2. 


*PLOTPARM T4107 NOLOGO 
This command selects a Tektronix 4100 (or 4200) series graphic terminal and 
switches off the GIMMS logo from the graphic display. 

*UTILITIES 


This command accesses the * UTILITIES Application Module. 


“EDIT FILEIN=11 FILEOUT = 12 / 
*EDIT accesses the edit subsystem. FILEIN specifies the channel from which the 
existing segment file will be read, while FILEOUT specifies the channel to which 
the new GIMMS segment file will written. 


N.B. The “EDIT command MUST be terminated by a slash (/). 


Within the *EDIT command the following parameters are available: 


FILEIN /\/ identifies input channel for existing segment file 
FILEOUT // identifies output channel for new segment file 
NZONES /l,=1000/ = specifies number of zones described in segment file 


Further Notes on *EDIT Parameters 


The following command would read an existing segment file from channel 11 and 
output results to channel 12: 


*EDIT FILEIN = 11,FILEOUT = 12 / 


Where more than 1000 zones are described in the segment file, the parameter 
NZONES ts required. For example: 


*EDIT FILEIN = 11, FILEOUT = 12, NZONES = 1500/ 


This command would allow input of up to 1500 zones. 


The *EDIT command MUST be terminated by a slash (/) and results in the input 
segment file being read and structured in a temporary file space. This process may 
take several minutes, depending on the size and complexity of the segment file. 
When the data has been read successfully, various editing commands may be used to 
investigate and correct segments In error. 


5.6.0.3 Selecting and Printing Segments 
*EDIT operates on selected subsets from the input segment file. These subsets are 
defined using the command SELECT. Those zones which were identified in previous 


diagnostic output as being in error generally form the basis of subset selections. 


A subset consists of a series of polygons (at least 1). In Figure 5.1(a) for example, three 
zones have been selected using the command: 


SELECT AQ3 A04 B10/ 


FIGURE 5.1 


(a) Selecting Segments 


SELECT A03 A04 B10/ 





N.B. When the segments selected are plotted on a graphic screen only lines and 
crosses will be displayed. 


(b) Printing List of Selected Segments 


PRINT 
SEG NAME 1 NAME 2 START FINISH 
7] AQ3 ] 2 
2 AQ3 AQ4 2 3 
3 A03 B10 3 4 
4 AQ3 4 1 
5 A0Q4 2 5 
6 AQ4 5 6 
7 AO4 6 7 
8 AQ4 B10 7 3 
9 B10 7 8 
10 B10 8 4 
Notes 


In the above examples 


(i) polygon are named A03, A04 and B10 
(11) segments are labelled $1 to $10 
(111) nodes are numbered 1 to 8 


Figure 5.1(b) illustrates output generated from the command PRINT. This command 
lists sequence numbers allocated to each segment extracted and labels segments in 
terms of the polygons to the left and right. For example, segment 2 (labelled $2 in 
Figure 5.1(a)) is referenced by the polygon names AQ3/ A04, while segment 1 (labelled 
$1 in Figure 5.1(a)) is referenced by the single name AQ3. In addition, sequence 
numbers allocated to nodes appear in the START and END columns and describe links 
in the network. 


Segment and node sequence numbers are used by several *EDIT commands e.g. 
REMOVE and JOIN. The numbers allocated vary depending on the subset selected. 
However, they do NOT reflect the sequence numbers allocated to the original 
digitised segment input during processing (see Section 4.3.1.1 under SEQUENCE). 


Editing is only possible when polygons on both sides of a segment have been 
SELECTed. In Figure 5.1(a) for example, only segments labelled $2, $3 or $8 may be 
edited. The following error message will be printed if an attempt is made to edit a 
segment where the relevant polygons have not been selected: 


** SEGMENT CHOSEN HAS ONLY ONE POLYGON SELECTED 


5.6.0.4. Identifying Nodes and Segments 
Several *EDIT commands require the user to identify specific nodes or segments by 


giving appropriate sequence numbers or by using the graphic cursor. These 
commands are described below: 


Identifying Nodes 


The commands JOIN and SPLIT allow nodes to be identified by sequence number. For 
example: 


JOIN NODENO 3 NODENO 7 NODENO 8 SET 


identifies the seqment between nodes numbered 3 and 7 (see Figure 5.1). The end of 
the segment currently attached to node 3 will be moved and attached to node 8. 


The same effect could be achieved using the graphic cursor to point at the nodes 
concerned. For example’ 


Command Sequence Explanation and Action 

JOIN: <cursor appears on graphic screen; 
position cursor over node 3; 
press space bar > 
<cursor appears on graphic screen; 
position cursor over node 8; 
press space bar > 
<cursor appears on graphic screen; 
position cursor over node 7; 
press space bar > 


SET <verfies JOIN operation > 
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When the graphic cursor is positioned on the screen, the nearest node will be selected. 
If no node exists within a selected tolerance distance the following error message will 
be printed and the action aborted: 


**** NODE NOT MATCHED WITHIN TOLERANCE 


N.B. Adescription how to use the graphic cursor is presented in Section 2.2.3.2. 


The command JOIN is fully described in Section 5.6.1.9. 


Identifying Segments 


Segments may be identified by sequence number or by the graphic cursor, depending 
on which editing command is being used. 


The commands REMOVE and RENAME require segments be identified by sequence 
number. The appropriate sequence number may be obtained using the PRINT 
command (see Section 5.6.0.3) or using the command IDENTIFY (see Section 5.6.1.19). 


The commands JOIN, SPLIT and IDENTIFY generally require that segments be 
identified using the graphic cursor to point at the appropriate nodes. 


N.B. \f the graphic cursor is being used, the command ZOOM provides a means to 
window into a selected area and therefore assist in identifying nodes which are 
close together (see Section 5.6.1.7). 


5.6.0.5 General Guidelines for Editing 


When a segment file is *CHECKed, several different digitising errors may generate the 
error message. 


**** ERROR IN BOUNDARY DESCRIPTION **** 


Although the reason for some of these errors may be deduced from the diagnostic 
output generated (see Section 5.5.2.0), others may be more difficult to interpret. 
Complex errors may be corrected relatively easily however, using the interactive 
editing facility. 

Some general guidelines on editing are given below. For the purposes of illustration, 
examples relate to a segment file containing 9 polygons named Ai to AQ with an 
external area called SEA. Polygon A7 isin error. 


Before accessing the interactive editor, it is advisable to obtain a printed copy of the 
most recent diagnostic output generated by *CHECK where DIAGS =2 (see Section 
5.2.0.0), a map of the segment file plotted using the command *DRAWMAP NAMES 
(see Section 6.1.3.2), and a copy of the the original map used during digitising. 


After the *EDIT subsystem has been accessed (see Section 5.5.0.2), the following 
command should be issued to exclude the external zone SEA from subsequent zone 
selections. 


EXCLUDE SEA 


Editing Procedures 


To identify and correct the error occurring in polygon A7 the following editing 
procedures may be used: 


(i) 


(ii) 


(111) 


(iv) 


The polygon A7 is selected and plotted on the graphic screen using the 
commands: 


SELECT A7/ 
DRAW 


SELECT retrieves all of the segments describing polygon A7 while DRAW 
plots the polygon on the graphic screen. 


At this stage, the reason for the error message generated by *CHECK may 
become apparent. For example, a segment may be missing or an extra 
segment may have been recorded. 


If asegment is missing, the command ADD may be used to digitise a new 
segment on the screen (see Section 5.6.1.15). Alternatively, if the line ts 
particularly complex, the segment may have to be recorded at the 
digitising table and then *MERGEd with the current segment file (see 
Section 9.5.0.0). 


The problem of recording an extra segment is discussed below. 


If after the polygon has been plotted all segments appear to be present, 
the following command should be issued: 


LINK A? 
lf the error still persists it may be due to: 


(a) segments not joining correctly at nodes or attaching themselves to 
the wrong nodes. 


This situation may arise when an incorrect value has been set for 
AUTONODE (see Section 4.3.1.0). 


(b) segment labelling does not conform to the direction of digitising. 


The PRINT command may be used to identify which segment(s) are 
mis-labelled (see Section 5.6.0.3). 


Procedures (1) and (ii) describe how to investigate a polygon identified as 
being in error. Individual segments however, cannot be altered until 
polygons on both sides are SELECTed. This may be achieved using the 
parameter ADJOIN. For example, the following command would select 
polygon A7 together with all adjoining polygons: 


SELECT ADJOIN A7 / 
A number of editing commands are available to correct segment errors. 


The most commonly used are JOIN, RENAME and SPLIT. These are 
described below. 


When changes are made to a polygon, the following command should be 
issued to check results: 


LINK A7 


When all errors have been corrected for the current zone, another 
polygon may be selected and the appropriate editing procedures 
repeated. 


N.B. When editing large segments files it is good practice to SAVE 
changes every 20 minutes or so to guard against system failure. 


Extra Segments 
The occurrence of an extra segment generally means that the wrong names have been 


allocated to one or more segments. If a map has been generated using the command 
*DRAWMAP NAMES, it should be possible to deduce correct names. 


To correct this type of error the polygons concerned should be SELECTed. For example, 
if the extra segment was labelled A7/A4 when it should have been labelled A5/A4 the 
following SELECT command would be required: 
SELECT A7 A5 A4/ 

The command PRINT may then be used to determine segment sequence numbers so 
that the segment in error could be RENAMEd as appropriate. For example, if the extra 
segment was allocated sequence number 3, the following RENAME command could 
be issued: 


RENAME 3 A5 A4 


Missing Segments 


If a segment Is missing when a polygon is SELECTed but appears on a map generated 
by the command *DRAWMAP, the following error may have occurred: 


(a) asegment may be wrongly labelled and therefore will not be SELECTed. 


In this case, it will occur as an extra segment for another polygon and will 
generally be visible on the plotted map. 


(b) twosegments may have been digitised as one for an adjoining polygon. 
This constitutes segment overshoot or concatenation (see Section 5.5.3.3). When 
located, the command SPLIT may be used to divide the segment in error. The 
command RENAME must also be used to rename the appropriate part of the 
segment. 


5.6.1.0 *Edit Commands 


Commands available within *EDIT are described below. 


5.6.1.1 END Command 

This command updates changes and saves results to an output segment file. Saving 
changes may take several minutes depending on the size and complexity of the 
segment data. 


The END command has no parameters. 


5.6.1.2 QUIT Command 
This command aborts the editing session. 
Within the command QUIT the following parameters are available: 


YES /K,EXIT/ aborts all editing 
NO /K,EXIT/ ignores QUIT command 


N.B. The parameter YES must be specified by the user to avoid accidentally QUITting 
from an editing session. 

5.6.1.3, SAVE Command 
This command saves the results of an editing session and returns control to the editor. 
This is a safety procedure to ensure against system failure. Unlike the command END, 
only the changes made since the last time the file was SAVEd will be recorded. 
The SAVE command has no parameters. 
5.6.1.4 SELECT Command 
This command allows users to select a subset from the segment file If the complete 
segment file was SELECTed, the buffer space provided by the editor may overflow and 
generate one of the following error messages: 

**** TOO MANY POLYGONS SELECTED 

or 

**** TOO MANY SEGMENTS 

or 


**** TOO MANY NODES 


The SELECT operation would then be aborted. 


Within the SELECT command the following parameters are available: 


POLYGON /L,EXIT/ specifies polygon to be selected 
ADJOIN /K,RETURN, = SPECIAL/ selects adjoining polygons 
EXCLUDE /L,RETURN/ excludes zone from polygon list 
FINISH (/) /K,EXIT/ terminates selection process 


SECTION 6 : *PLOTPROG and *COMPILE APPLICATION MODULES 
CONTENTS 


6.0.0.0 GENERATING GRAPHIC OUTPUT 

6.1.0.0 THE *PLOTPROG APPLICATION MODULE 
6.1.1.0 Input and Output 
6.1.2.0 Command Input 
6.1.3.0 Commands Available 


*NEWMAP Command 

*GIMMSFILE,*ROTATE, *SCALE, *ORIGIN 
and *DRAWMAP Commands 

*MAP, *VARIABLE and *MAPTYPE Commands 

*TEXT Command 

*LEGEND Command 

*LEVELS, *CLASSIFY, *HISTOGRAM and 

*INTERVALS 

Commands 

*SYMBOLISM Command 

*GRAPH, *BARGRAPH and *SCATTER 
Commands 

*PIE Command 

*FRAME/*BOX, *GRID, *WINDOW/*SCISSOR 
and*SHIELD Commands 

*DRAW Command 

*POINT Command 

*DOT Command 

*NORTHPT Command 

*ARROW Command 

*PEN Command 

*LINETYPE Command 

*SETLINES Command 

*OUTLINE Command 

*JOINSCAN Command 
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6.2.0.0 THE *COMPILE APPLICATION MODULE 
6.2.1.0 Commands Available 
6.2.2.0 Further Notes on Commands 
6.2.3.0 Compilation Commands 


*COMMANDS Command 


6.2.3.1 
6.2.3.2 *MOVE Command 


6.2.3.3 Miscellaneous Commands 
6.2.3.4 *ZOQOM Command 


6.0.0.0 GENERATING GRAPHIC OUTPUT 

Graphic output is generated by three Application Modules: 

*PLOTPROG to produce statistical maps and business graphs 

*COMPILE to design base maps on an interactive graphic terminal 

*“GRAPHICS to produce business graphs 

oe *COMPILE and *GRAPHICS may be accessed from the Main Control 
rogram: 


<Commands available from the Main Control Program > 


*PLOTPROG <to access the *PLOTPROG module > 
<Commands available within *PLOTPROG > 
*END <to return to the Main Control Program > 
*STOP <to terminate the GIMMS command run> 


The *GRAPHICS Application Module is described in Section 7. 


6.1.0.0 THE *PLOTPROG APPLICATION MODULE 


GIMMS locational and non-locational data files are brought together by the 
*PLOTPROG module to produce statistical maps. For example: 


*FILEPARM 12 ‘POLYGONS' GIMMS <identifies GIMMS locational data 
file> 

*FILEPARM DATA 'DATAFILE’ GIMMS <identifies GIMMS non-locational DATA 
file> 

*FILEPARM 19 'PLOTFILE’ TEXT <directs graphic output > 

*PLOTPARM PLOTTER <selects pen plotter > 

*PLOTPROG <accesses *PLOTPROG module > 

*NEWMAP MAPSIZE = 18,24 FRAME <specifies size of plotting window> 

*GIMMSFILE FILE = 11 <specifies input channel for locational 
data file> 

*MAP VARIABLE = POP MAPTYPE = AREA <identifies variable to be mapped and 
map type > 

*END <exits from *PLOTPROG > 

*STOP <terminates the GIMMS command 
run> 


Output from this example is illustrated in Figure 6.1. 


The above GIMMS command run generates an area shaded map. This map relies 
heavily on default settings for map symbolism and legend production. There are 
however, numerous commands available within *PLOTPROG to considerably modify 
this design. For example, different class intervals can be selected, symbolism redefined 
and titles and footnotes specified: 


Figure 6.1 








. (SPR 
meee | TT TTT tith 
 .  * (eR EBeEEE 
: eto lr 
_oosts SES SSSS 
A+++ eT ttt 
peenenensene 
SHRSSSSTSSBO. .4BBSSSSOSSSOBOSE: 


| 

| 

| 

| 

| 

| 

: | 

fon pase 53 aT TITililiy Tt Lr a tt ‘4 } N | 
id ee, Fae LY ; 

ie i 

| 

| 

| 

| 

| 





ryT te} rity ee 
S808, SSSSSSERRSECHSSTC CT AGSSERGG008' 
eS (SSGCRSSREPeBeeesessvaaecenanas 
a 
28S OF C8 SESS SSOSCOTSCS RETA, 
[SS SOS SS CSOeCEessseseanasen: 
080500 SESSSTSESSEESEAR RCE, 
06 len ne SOROS SOSS0REGR 
egseaneseseace, 
3G88 SS5G0088' 
eeauagueesus 
Wiltioa tit iy 


el 


*FILEPARM 12 ‘POLYGONS’ GIMMS 
*FILEPARM DATA 'DATAFILE’ GIMMS 
*FILEPARM 19 'PLOTFILE' TEXT 


*PLOTPARM PLOTTER 

*PLOTPROG 

*NEWMAP MAPSIZE = 18,24 FRAME 
*GIMMSFILE FILE = 11 


*LEVELS 3 

*INTERVALSVARIABLE = POP 

USER = 54000,90000, 140000, 180000 
*SYMBOLISM AREA 

GRID = 0.18,0.08,0.05 


*LEGEND POSITION = 11,12 
BOXSIZE = 0.5 


*TEXT KEY = TOP ALPHABET = 32 
TEXT = ‘Persons’ 


*MAP VARIABLE = POP MAPTYPE = AREA 


*TEXT POSITION = 7,22.5 
SIZE=0.8 

TEXT = ‘U.K. REGIONS' 
SHADE ALPHABET = 61 


*TEXT POSITION = 6,0.5 
SIZE =0.7 ALPHABET = 16 
TEXT = Total Population’ 


*BARGRAPH SAMEPAGE 
VARIABLE = POP 


SHADE FREQ CLASSES 
ORIGIN = 12,16 LENGTH = 3,5 NOXLABEL 


*END 
*STOP 


<identifies GIMMS locational data 
file> 

<identifies GIMMS non-locational 
DATA file> 


<directs graphic output > 


<selects pen plotter > 

<accesses *PLOTPROG module> 
<specifies size of plotting window > 
<specifies input channel for locational 
data file> 

<specifies number of class intervals > 
<identifies variable to be mapped and 
specifies class intervals > 

<redefines map symbolism > 


<specifies position of legend and size of 
legend boxes > 

<specifies title for legend > 

<identifies variable to be mapped and 
map type> 


<specifies main title > 


<specifies foot note> 


<generates frequency histogram > 


<exits from *PLOTPROG > 
<terminates the GIMMS 
run> 


command 


Output from this example is illustrated in Figure 6.2. 


6.1.1.0 Input and Output 


Locational data files are input to *PLOTPROG using the *GIMMSFILE command (see 


Section 6.1.3.2). 


Graphic output is controlled by the *PLOTPARM command (see 


Section 3.3.1.3) and is generally directed to a file on channel 19. 


By default, command input is read from channel 5 and diagnostic output directed to 


channel 6. 
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Figure 6.2 


6.1.2.0 Command Input 


*PLOTPROG requires at least one *NEWMAP command to generate graphic output. 
Other commands should be given in a logical sequence. The command *END exits 
from *PLOTPROG and returns control to the Main Control Program. 


6.1.3.0 Commands Available 


Commands available within the *PLOTPROG module may be divided into five main 


types: 
1. System Commands 


*SYSPARM 
*PLOTPARM 
*TEXTPARM 
*END 
*MANIPULATE 
“UTILITIES 
*CALL 


specifies system parameters 
specifies plotting parameters 
specifies text parameters 

exits from *PLOTPROG 

accesses the *MANIPULATE module 
accesses the *UTILITIES module 
accesses GIMMS macros 


*SYSPARM, *PLOTPARM and *TEXTPARM are described in Section 3, 
*MANIPULATE in Section 8, and *UTILITIES and *CALL in Section 9. 


2. Data Access Commands 
*GIMMSFILE 


*VARIABLE 
*RESTORE 


specifies input channel for locational 
data file 

specifies variable to be mapped 
restores a non-locational DATA file 


*RESTORE is described in Section 9; the remaining commands are discussed 


below. 


3. Output Commands 


*DRAWMAP 
*MAP 

ECT 
*DRAW 
*NORTHPT 
*POINT 

*DOT 
*FRAME/*BOX 
*GRID 
*GRAPH 
*BARGRAPH 
*SCATTER 
*PIE 
*ARROW 
*HISTOGRAM 


plots locational data file 

generates legend and map 
specifies text to accompany map 
plots straight lines between points 
specifies north arrow 

specifies point symbols 

specifies dot symbols 

plots a frame or box 

plots a grid 

specifies a line graph 

specifies a bar graph 

specifies a scattergram 

specifies a pie graph 

specifies an arrow symbol 

generates a histogram from one or 
more non-locational DATA variables 


*GRAPH, *BARGRAPH, *SCATTER and *PIE are described in Section 7: the 


remaining commands are discussed below. 


Plot control commands 


*NEWMAP 
*NEWSHEET 

*PEN 

*LINETYPE 

*SCISSOR / * WINDOW 


*SHIELD 


Output Parameter Commands 
*ROTATE 


*SCALE 
*ORIGIN 


*LEGEND / *KEY 


*LEVELS 

*INTERVALS and *CLASSIFY 
*SYMBOLISM 

*OUTLINE 

*SETLINES 

*“MAPTYPE 


specifies size of plotting window 
selects change of paper/ film 

selects pen change 

selects change of line type 

defines a rectangular area within 
which plotting will occur 

defines a rectangular area within 
which plotting will not occur 


rotates study area within the plotting 
window 

specifies scale for study area 
positions study area within the 
plotting window 

specifies position and format of map 
legend 

specifies number of class intervals 
specifies values for class intervals 
defines map symbolism 

controls plotting of map outlines 
defines line type(s) 

specifies symbolism type 


N.B. Within a GIMMS command run only a subset of the above commands will be 
accessed. The commands *NEWMAP and *END however, must always be 
selected. 


6.1.3.1 *NEVWMAP Command 


This command specifies the dimensions of the plotting window and MUST be selected 
before any graphic output can be generated. 


Within *NEWMAP the following parameters are available: 


XDIM (X) (XVALUE) (MAPSIZE) /R,:D, = 20.0/ specifies X-dimension of 
plotting window In centimetres 
/R,:D, = K:XDIM/ specifies Y-dimension of 
plotting window in centimetres 
FRAME(F) (BOX) (NEATLINE) /K, = ON(INTER)/ plots a frame or neat line 
around the plotting window 
rotates plot through 90 degrees 


YDIM (Y) (YVALUE) 


ROTATE (DEG) (TURN) /K/ 


Further Notes on *NEWMAP Parameters 
XDIM, YDIM, MAPSIZE 


The parameters XDIM and YDIM (or MAPSIZE) specify the X and Y dimensions of 
the plotting window. For example: 


*NEWMAP MAPSIZE = 20, 30.5 


This command defines a plotting window measuring 20 centimetres in the X- 
dimension and 30.5 centimetres in the Y-dimension. 


If avalue for YDIM is not specified it is assumed to be the same as the value for 
XDIM. For example: 


*NEWMAP XDIM = 15 
This command defines a plotting window measuring 15 by 15 centimetres. 


N.B. Nographic output will be generated outside the plotting window. 


FRAME 


This parameter may be specified to produce a frame or neat line around the 
plotting window. For example: 


*NEWMAP MAPSIZE = 20, 30.5 FRAME 


N.B. <A frame is automatically generated around the plotting window when 
GIMMS Is operating interactively. 
ROTATE 
This parameter rotates the entire plot through 90 degrees. For example: 
*NEWMAP MAPSIZE = 20, 30.5 FRAME ROTATE 
would generate a plot measuring 30.5 centimetres in the X-dimension and 20 


centimetres in the Y-dimension. All graphic objects defined within the plotting 
window would also be rotated through 90 degrees. 


6.1.3.2 *GIMMSFILE,* ROTATE, * SCALE, * ORIGIN, and *DRAWMAP Commands 

When a locational data file has been created, these commands are used to reference, 
position and plot the data within the plotting window. The function of each 
command is as follows: 


*GIMMSFILE selects and identifies the appropriate channel to which the 
locational data file has been assigned; 


*ROTATE rotates locational data through a specified number of degrees; 
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*SCALE 
*ORIGIN 


*DRAWMAP 


specifies map scale for locational data; 
positions locational data within the plotting window; 


plots outlines of locational data within the plotting window 


using the values specified for *ROTATE, *SCALE and *ORIGIN. 


These commands share a number of parameters: 


FILE 


GRIDFILE (GRID) 
DATAFILE (DATA) 


SCALE (FRACTION) 


XFACTOR (FACTOR) (F) (FACTORS) 
YFACTOR 


XPLOT (XORG) (XORIGIN) (ORGX) 
YPLOT (YORG) (YORIGIN) (ORGY) 


XMAP (MAP) 


YMAP 


XSIZE (SIZE) 

YSIZE 

SEQUENCE (SEQ) (SEQNO) 
CROSS 

NAMES 

HEIGHT 


OUTLINES 


BOUNDARY (UNION) (BORDER) (EXTERNAL) 


NMAPX (NEWMAP) (MAPSIZE) 
NMAPY 

INFO 

XSHIFT (SHIFT) 


YSHIFT 
ROTATE (TURN) (ROT) 


/|,PERM/ 


/K,PERM/ 
/K,PERM/ 


/\/ 


/R,PERM/ 


specifies input channel for 
locational data file 

selects GRID file 

specifies the use of point data 
from anon-locational DATA file 
specifies map scale as a 
representative fraction 

specifies X-scaling factor 


/R, = K:XFACTOR,PERM/ 


/R,:P,PERM/ 
/R,:P,PERM/ 


/R,PERM/ 


/R,PERM/ 


/R,PERM/ 
/R,PERM/ 
/K/ 
/K/ 


/K/ 
/R, =0.2/ 


specifies Y-scaling factor 
specifies X-origin position for 
locational data 

specifies Y-origin position for 
locational data 

specifies origin position in 
relation to  X-coordinate in 
locational data 


specifies origin position § in 
relation to Y-coordinate in 
locational data 
specifies X-dimension for 
locational data 
specifies Y-dimension for 


locational data 

plots sequence number at data 
point 

plots cross symbol at data point 
plots zone name at data point 
specifies size for zone name or 
cross symbol 


/L, = ALL(BATCH), = OUT(INTER)/ 


/R, = 30.0/ 


switches boundary outlines on 
or off 


/K, = ON(INTER)/ 


plots external boundary 
specifies X-dimension for new 
plotting window 


/R, =K:NMAPX/ specifies Y-dimension for new 


/K/ 


/R,;-M,PERM/ 
/R,;M,PERM/ 
/R,:A,PERM/ 


plotting window 

scales SIZE on zone limits, not on 
sheet limits 

specifies X-origin shift 

specifies Y-origin shift 

specifies angle for rotation 


INCLUDE (GENERAL) /l,=9,PERM/ — specifies generalisation level for 


Polygon files 

METRE (METER) (UNITS) /R/ specifies units for SCALE 

VARX (XVAR) /\/ specifies X-variable number for 
DATAFILE 

VARXNAME /L/ specifies X-variable name _ for 
DATAFILE 

VARY (YVAR) /\/ specifies Y-variable number for 
DATAFILE 

VARYNAME /L/ specifies Y-variable name _ for 
DATAFILE 


These parameters will be discussed below under the appropriate commands. 


Further Notes on *GIMMSFILE Parameters 


FILE 


This parameter identifies the channel number to which a locational data file has 
been assigned using the command *FILEPARM (see Section 3.3.1.2). Point, Line, 
Segment or Polygon files may be referenced in this way. For example: 


*GIMMSFILE FILE = 11 
This command identifies a locational data file assigned to channel 11. 


Values for scaling factors and map origin will be automatically calculated for the 
locational data file in relation to the dimensions specified for *NEWMAP. For 
example: 


*FILEPARM 11 'UKPOLY’ GIMMS 
*FILEPARM 19 'UKPLOT’ TEXT 
*PLOTPARM PLOTTER 
*PLOTPROG 
*NEWMAP MAPSIZE = 8, 12 FRAME 
*GIMMSFILE FILE = 11 
*DRAWMAP OUTLINES = ALL 
*END 
*STOP 


Output from this GIMMS command run is illustrated in Figure 6.3 (a). The 
locational data has been automatically scaled and positioned to fit within the 
plotting window. 


INCLUDE,GENERAL 


The parameter INCLUDE (or GENERAL) specifies the generalisation level to be 
used when plotting Polygon files. The generalisation process is described in 
Section 5.1.0.0 under GENERAL. 


By default INCLUDE is set to 9 and all points in the Polygon file will be plotted. A 
setting of 0 will include only segment end points, while settings from 1 to 8 will 
select intermediate levels. For example: 


*GIMMSFILE FILE = 11 INCLUDE = 5 


This command identifies a Polygon file on channel 11 and selects only those 
points referenced with a generalisation code of 5 or less. 


Specifying a value for INCLUDE less than 9 can significantly increase plotting 
speed on some devices, notably graphic terminals. 


N.B. The parameter INCLUDE may only be used successfully with Polygon files 
created by the command *POLYGON GENERAL (see Section 5.1.0.0 under 
GENERAL). 


GRIDFILE 


This parameter is used to reference a GRID file which has been previously 
assigned using the command *FILEPARM GRID (see Section 3.3.1.2). For 
example: 


*FILEPARM GRID ‘'GRID1' GIMMS 
*FILEPARM 19 ‘PLOTFILE’ TEXT 
*PLOTPARM PLOTTER NOLOGO 


*PLOTPROG 
*NEWMAP MAPSIZE = 20,15 FRAME 


*GIMMSFILE GRIDFILE 

“INTERVALS GRID VARIABLE = V1 
USER = 0, 20, 40, 60, 80, 100 

*MAP VARIABLE = V1 TYPE= AREA 


*END 
*STOP 


This GIMMS command run generates a map using the GRID file variable V1. 


Values for scaling factors and map origin are calculated automatically in relation 
to the dimensions specified for *NEWMAP. 


DATAFILE, VARX, VARY 


These parameters may be used to generate a point map from coordinates stored 
ina non-locational DATA file. 


The parameter DATAFILE is used to reference the non-locational DATA file, 
previously assigned using the command *FILEPARM DATA (see Section 3.3.1.2). 


Coordinates for point locations are stored as variables within the DATA file and 
identified using the parameters VARX and VARY. For example: 


*FILEPARM DATA ‘DATA1' GIMMS 
*FILEPARM 19 ‘PLOTFILE’ TEXT 
*PLOTPARM PLOTTER 


*PLOTPROG 
*NEWMAP MAPSIZE = 20,15 FRAME 
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*GIMMSFILE DATAFILE XVAR = XCOORD YVAR = YCOORD 
*SCALE FACTOR = 0.002 

*ORIGIN PLOT = 1, 2.5 

*MAP VARIABLE = PTVAR1 MAPTYPE = POINT 


*END 
*STOP 


This GIMMS command uses the coordinate values stored in the variables 
XCOORD and YCOORD to generate a point map of the variable PTVAR1. 


N.B. When this type of map is being produced, values for *SCALE and *ORIGIN 
are generally required (see below). 


Further Notes on *ROTATE Parameters 
ROTATE 


This parameter may be used to rotate locational data through a specified 
number of degrees in an anti-clockwise direction. For example: 


*NEWMAP MAPSIZE = 8,12 FRAME 
*GIMMSFILE FILE = 11 

*ROTATE = 45 

*DRAWMAP OUTLINES = ALL 


would rotate the study area through 45 degrees and graphic output would be 
similar to Figure 6.3 (b). The scale and position of the study area within the 
plotting window are automatically reset by *ROTATE. 


N.B. *ROTATE is fundamentally different from *NEWMAP ROTATE. The latter 
command rotates the plotting window and all the graphic objects 
defined therein through 90 degrees. 


Further Notes on *SCALE Parameters 


XSIZE, YSIZE 


These parameters may be used to specify the dimensions of a study area when 
plotted. For example: 


*SCALE XSIZE = 10 


would scale the locational data so that when plotted it would measure 10 
centimetres wide. Similarly, the command: 


*SCALE YSIZE = 12 


would scale the study area so that when plotted it would measure 12 centimetres 
high. 
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In both cases, appropriate scaling factors are calculated using the values 
originally specified for LIMITS (see Section 4.3.1.0). 


The following GIMMS command run was used to generate Figure 6.3 (c): 
*FILEPARM 11 ‘UKPOLY' GIMMS 
*FILEPARM 19 ‘PLOTFILE’ TEXT 
*PLOTPARM PLOTTER NOLOGO 


*PLOTPROG 
*NEWMAP MAPSIZE = 8, 12 FRAME 


*GIMMSFILE FILE = 11 
*SCALE SIZE = 3 
*DRAWMAP OUTLINES = ALL 


*END 
*STOP 


The study area Is scaled automatically to measure 3 centimetres wide (i.e. SIZE = 
3). 


N.B. Positioning of the study area within the plotting window is reset by the 
command *SCALE and may be altered using *ORIGIN (see below). 


INFO 
By default, scaling is performed using the values specified for sheet LIMITS (see 
Section 4.3.1.0). However, when a Polygon file is created, the actual window 
within which the study area falls is also calculated and stored. This is known as 
the zone limits and its values are generally less than the sheet LIMITS. 


if the parameter INFO is specified, the zone limits are used for scaling as opposed 
to the sheet LIMITS. 
XFACTOR, YFACTOR 


These parameters are used to convert coordinates in the locational data file to 
positions within the plotting window. For example: 


*SCALE XFACTOR = 0.001 


would convert the coordinate value (10000, 12000) to the position (10.0, 12.0)cm 
within the plotting window i.e. ((1000*0.001),(12000*0.001)). 


if a value for YFACTOR is not specified it is set automatically to the same value as 
XFACTOR. 


SCALE, FRACTION, METRE 


These parameters may be used to express map scale as a representative fraction. 
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This method of specifying scale depends on the coordinates in the locational 
data file being recorded in terms of metres on the ground. For example, if the 
coordinates in the locational data file were recorded to a 10 metre resolution the 
following command would be required to generate a map at 1:50000 scale: 


*SCALE FRACTION = 50000 METRE = 10 
Similarly, the command: 
*SCALE FRACTION = 50000 METRE = 0.01 


would mean that coordinates in the locational data file had been recorded to a 1 
centimetre resolution (i.e. METRE = 0.01). 


Further Notes on *ORIGIN Parameters 
XPLOT, YPLOT, PLOT 


The parameters XPLOT and YPLOT (or PLOT) specify the position for the origin of 
the locational data within the plotting window. Values for XPLOT and YPLOT 
are expressed in centimetres and are added to the coordinates in the locational 
data file after they have been appropriately scaled. For example: 


*SCALE FACTOR = 0.001 
*ORIGIN PLOT = 1, 2.5 


would result in the coordinate (10000, 12000) in the locational data file being 
plotted at the point (11, 14.4)cm within the plotting window ie. 
((10000*0.001 + 1),{12000*0.001 + 2.5)). 


XMAP, YMAP, MAP 


The parameters XMAP and YMAP (or MAP) are used to directly relate a 
coordinate (expressed in map units) from the locational data file to a point 
(expressed in centimetres) within the plotting window. For example: 


*ORIGIN XPLOT = 10 YPLOT =12.5 XMAP= 10000 YMAP = 12000 


would result in the map coordinate (10000, 12000) being plotted at the point 
(10, 12.5)cm within the plotting window. 


The following GIMMS command run was used to generate Figure 6.3(d): 


*FILEPARM 11 'UKPOLY' GIMMS 
*FILEPARM 19 'PLOTFILE’ TEXT 
*PLOTPARM PLOTTER NOLOGO 
*PLOTPROG 
*NEWMAP MAPSIZE = 8, 12 FRAME 
*GIMMSFILE FILE = 11 
*SCALE SIZE = 3 
“ORIGIN PLOT = 4,6 MAP = 2550, 1650 
*DRAWMAP OUTLINES = ALL 
*END 
*STOP 
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The map produced is first scaled using the command *SCALE and then positioned 
within the plotting window using the command *ORIGIN. The coordinate 
(2550,1650) from the locational data file is plotted at the point (4,6)cm. 


In this example, values for PLOT and MAP correspond to the mid-points of both 
the plotting window and the locational data. The study area is therefore centred 
within the map frame. 


N.B. The parameters XMAP and YMAP are extremely useful when zooming 
into an area as the MAP coordinate specified will remain at the same 
position within the plotting window despite changes in scale. 


XSHIFT, YSHIFT 


These parameters may be used to move the study area within the plotting 
window after an origin value has been specified. For example: 


*ORIGIN PLOT 1, 2.5 


*ORIGIN XSHIET = 5, YSHIFT = -3 


The second *ORIGIN command would shift the previous origin 5 centimetres in X 
and -3 centimetres in Y. 


This technique of shifting the origin is particularly useful when several maps of 
the same study area are being produced within the plotting window. 


Notes on using *GIMMSFILE, *ROTATE, *SCALE, and *ORIGIN 


1. 


These commands are used to identify, scale, and position locational data so that 
it may be plotted using the commands *DRAWMAP and *MAP. In addition, they 
may be used by commands such as *TEXT and *DRAW when the parameter 
MAPUNITS has been selected. 


Values specified for *SCALE and *ORIGIN may result in all or part of the 
locational data falling outside the plotting window. 


The parameters available within each of these commands may be combined to 
form asingle command. For example: 


*GIMMSFILE FILE = 11 FACTOR = 0.001 
PLOT = 10, 12.5 MAP = 10000, 12000 


This command Is equivalent to specifying: 
*GIMMSFILE FILE = 11 


*SCALE FACTOR = 0.001 
*ORIGIN PLOT = 10, 12.5 MAP = 10000, 12000 
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4. When these commands are issued separately they should always be specified in 
the following order: 


*GIMMSFILE 

*ROTATE 

*SCALE 

*ORIGIN 
If, at a later stage, it becomes necessary to move the map origin then only the 
command *ORIGIN need be redefined. 


If it becomes necessary to change the map scale then the command *SCALE, and 
possibly *ORIGIN, need be redefined. 


If it becomes necessary to change the map rotation, then *ROTATE, and possibly 
*SCALE and *ORIGIN need be redefined. 


If it becomes necessary to identify a different locational data file then all 4 
commands may require to be altered. 


Further Notes on *DRAWMAP Parameters 


This command ts used to plot a locational data file. Parameters are also available to 
scale and position the study area within the plotting window. 


SEQUENCE, CROSS, NAMES, HEIGHT 


These parameters may be used to select which information accompanies zone 
outlines when they are plotted. For example: 


SEQUENCE -_ plots zone sequence numbers 
CROSS - plotssmall cross symbols 
NAMES - plots zone names 


In all cases, the selected information is plotted at zone centroids. For Point files 
this is the location of individual points; for Line and Segment files this is the 
centre of the line; for Polygon files this is the zone centroid calculated by the 
*POLYGON subsystem (see Section 5) or located using *MODCENT (see Section 
9.6.0.0). 


The parameter HEIGHT may be used to specify the letter height for SEQUENCE 
numbers or zones NAMES, or the size of CROSS symbols. For example: 


*DRAWMAP CROSS HEIGHT = 0.3 
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This command would plot cross symbols measuring 0.3 centimetres in height at 
zone centroids . 


If in a Line or Segment file a zone is referenced by more than one name, these 
names will be plotted one below the other. 


When plotting a Point file the parameter NAMES has no effect as names cannot 
be allocated to individual points. 


OUTLINES, ALL, NONE, OUT, BOUNDARY 


These parameters are used to specify the level of linear information to be plotted 
for Line and Segment files. For example: 


ALL all lines will be plotted 


NONE no lines will be plotted and, unless SEQUENCE, CROSS or 
NAMES have been specified, no output will be generated 


OUT and BOUNDARY - only the external boundary for the study area will be 
plotted These parameters may only be applied to Polygon files 
which have not been modified or manipulated after creation. 


The following command would plot all lines stored in the GIMMS locational data 
file: 


*DRAWMAP OUTLINES = ALL 


N.B. When GIMMS is operating in batch mode, the default setting for 
OUTLINES is ALL (i.e. OUTLINES= ALL); when GIMMS is being used 
interactively, the default setting for OUTLINES ts OUT (i.e. OUTLINES = 
OUT). 


ROTATE, FACTORS, SIZE, ORIGIN 


These parameters may be used within the current *~DRAWMAP command to 
override values specified for *ROTATE, *SCALE and *ORIGIN. 


FILE, GENERAL 


These parameters may be used to override the *GIMMSFILE file specification. 
They do not however, alter values for *ROTATE, *SCALE, or *ORIGIN. For 
example: 


*FILEPARM 11 ‘POLY1' GIMMS 
*FILEPARM 12 'POLY2’ GIMMS 
*FILEPARM 19 'PLOTFILE’ TEXT 
*PLOTPARM PLOTTER 


*~PLOTPROG 
*NEWMAP MAPSIZE = 10,20 FRAME 
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*GIMMSFILE FILE = 11 
*SCALE FACTOR =0.001 
*ORIGIN PLOT = 10,12.5 MAP = 10000,12000 


*DRAWMAP FILE = 12 GENERAL = 3 


*END 
*STOP 


This GIMMS command run plots the Polygon file assigned to channel 12 as a 
result of the command *DRAWMAP FILE =12 GENERAL =3. Only those points 
specified with a generalisation code of 3 or less will be plotted. Values specified 
for the preceding *SCALE and *ORIGIN commands will be used to scale and 
position the study area within the plotting window. 


NMAPX, NMAPY, NEWMAP 


In general, *DRAWMAP will plot the specified study area within the plotting 
window defined by *NEWMAP. However, if the parameters NMAPX and 
NMAPY (or NEWMAP) are issued, a new plotting window will be initialised. For 
example: 


*FILEPARM 11 ‘POLY1' GIMMS 
*FILEPARM 19 ‘PLOTFILE’ TEXT 
*PLOTPARM PLOTTER 


*PLOTPROG 
*NEWMAP MAPSIZE = 10,20 FRAME 


*GIMMSFILE FILE = 11 

*SCALE FACTOR = 0.001 

*ORIGIN PLOT = 10,12.5 MAP = 10000,12000 
*DRAWMAP SEQUENCE 

*DRAWMAP CROSS NEWMAP = 30, 20 


*END 
*STOP 


This GIMMS command run would firstly plot the Polygon file assigned to channei 
11 within a plotting window measuring 10 by 20 centimetres. A second plotting 
window is initialise by the command *DRAWMAP NEWMAP._ This would 
measure 30 by 20 centimetres and the Polygon file would again be plotted but 
with the origin and scale reset as appropriate. 

6.1.3.3 *MAP, *VARIABLE and *MAPTYPE Command 

*MAP Command 


This command its used to generate statistical maps. It may be specified several times in 
a GIMMS command run to produce a number of maps within the same plotting 
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window. In general, each map will be accompanied by different values for *ORIGIN 
(see Section 6.1.3.2). For example: 


*ORIGIN PLOT = 1,1 
*MAP VARIABLE = V1 MAPTYPE = AREA 


*ORIGIN SHIFT = 10.0 
«MAP VARIABLE = V2 MAPTYPE = POINT 


would generate two separate maps side-by-side within the same plotting window. 
When each *MAP command ts processed, a legend will be plotted before the map is 
generated. The position and format of legends may be controlled by the command 
*LEGEND (see Section 6.1.3.5). 


By default, *MAP plots the locational data referenced by the command *GIMMSFILE 
see (Section 6.1.3.2), unless the command *OUTLINE NONE has been specified. For 
Point files this results in point symbols being generated at appropriate locations. The 
format of these symbols may be defined using the command *SYMBOLISM POINT (see 
Section 6.1.3.7). For Line and Segment files, the appropriate lines are plotted; for 
Polygon files, the appropriate boundaries are plotted. 


The following commands (when specified) should always precede the relevant *MAP 
command as they affect the appearance of the resulting map 


*GIMMSFILE *ROTATE *SCALE 
*ORIGIN *LEVELS *INTERVALS 
*SYMBOLISM *LEGEND *OUTLINE 


Within *MAP the following parameters are available: 


VARIABLE (VAR) (VARS) (V) /\,=(C:VARIABLE)/ = specifies variable number 

VARNAME (NAME) /L,=(C:VARIABLE)/ specifies variable name 

MAPTYPE (TYPE) /l,=(C:MAPTYPE)/ specifies type of map to be 
generated 

AREA /K,RETURN/ selects area shaded map 


POINT /K,RETURN/ selects point map 

LABEL /K,RETURN/ selects label map 

DOT /K,RETURN/ selects dot map 

NAME /K,RETURN/ plots zone names at centroids 

SEQUENCE /K,RETURN/ plots zone sequence numbers at 
centroids 

CONTOUR /K,RETURN/ selects contour map 

NOLIST /K,RETURN/ switches off diagnostic listing 
giving zone values and levels 

DAFPT (DA) /\,=|,RETURN/ specifies number of digits after 
point for diagnostic listing 

CONT /K,RETURN/ prints additional diagnostic 
information for maps using 
continuous symbolism 

NAMESIZE /|,=8,RETURN/ specifies length for zone names 
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JOINSCAN /I/ switches on joinscan shading for 
AREA maps 


Further Notes on *MAP Parameters 
VARIABLE, VARNAME, VARS 


These parameters specify the variable to be mapped from those stored in the 
associated non-locational DATA file. 


Variables may be referred to by name or by giving their position in the non- 
locational DATA file. For example: 


*MAP VARIABLE = OVERTIME MAPTYPE = AREA 
<maps variable OVERTIME > 


*MAP VARIABLE = 5 MAPTYPE = AREA 
<maps the fifth variable in the DATA file > 


When the variable is selected, the MAPTYPE must also be specified (see below). 
In the above examples, the MAPTYPE is set to AREA and therefore area shaded 
maps will be produced. 
More than one variable may be specified in the *MAP command to generate 
multi-component point maps (see below). 

MAPTYPE, AREA, POINT, LABEL, DOT, NAME, SEQUENCE, CONTOUR 
The parameter MAPTYPE specifies the type of map to be produced: 
MAPTYPE = AREA 


generates an area shaded map similar to Figure 6.4(a). 


Area symbolism may be defined by issuing the command *SYMBOLISM AREA 
(see Section 6.1.3.7) prior to *MAP. 


A legend will be automatically generated when AREA maps are selected. 

N.B. AREAsymbolism should only be used in conjunction with GIMMS Polygon 
files. 

MAPTYPE = POINT 

generates a point symbol map similar to Figure 6.4(b). 


Point symbols may be defined by issuing the command *SYMBOLISM POINT (see 
Section 6.1.3.7) prior to *MAP. 


A legend will be automatically generated when POINT maps are selected to 
display single variable distributions. However, when multi-component point 
symbolism is requested and several variables are being mapped, the command 
*POINT may be required to produce more complex legends (see Section 
6.1.3.12). 





Figure 6.4 
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TWINY 


This parameter will duplicate the Y-axis to the right of the graph. This facility is 
illustrated in Figure 7.3 


YMIN, YMAX, YUNITS, YTICKS 


Unlike the X-axis, there is no relationship on the Y-axis between the number of 
ticks and the number of data points. 


The Y-axis provides a scale against which data values are measured. The 
parameters YMIN and YMAX are used to specify this scale, while YUNITS and 
YTICKS determine the number of tick marks and the position of labels. For 
example: 


YMIN=0 YMAX=100 YUNITS=20 YTICKS=4 


would result in five tick marks being plotted, labelled 0, 20, 40, 60, 80 and 100 
respectively. Between the tick marks, three sub-ticks would be plotted to divide 
the YUNITS into quarters (YTICKS = 4). Output from this example is illustrated in 
Figure 7.13. 


There is always one less sub-tick plotted than the number specified by YTICKS as 
the last coincides with a major tick. 
TICKSIZE, STICSIZE, XTICSIZE, YTICSIZE, YSTICSIZ 


These parameters are used to specify the length of ticks and sub-ticks. For 
example: 


TICKSIZE = 0.2 
would generate ticks and sub-ticks 0.2 centimetres long. 


The parameter STICSIZE is used to explicitly specify the length of sub-ticks. For 
example: 


TICKSIZE = 0.2 STICSIZE = 0.1 


would produce major ticks measuring 0.2 centimetres and sub-ticks measuring 
0.1 centimetres. 


In some cases different sizes of ticks and sub-ticks may be required for each axis. 
For example: 


XTICSIZE = 0.2 XSTICSIZ = 0.1 YTICSIZE = 0.3 YSTICSIZ = 0.15 
would plot major ticks measuring 0.2 centimetres on the X-axis, and 0.3 


centimetres on the Y-axis, and sub-ticks measuring 0.1 centimetres on the X-axis 
and 0.15 centimetres on the Y-axis. This is illustrated in Figure 7.14(a). 
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If values are negative, ticks will be plotted to the inside of the axes. For 
example: 


YTICSIZE = -0.3 YSTICSIZ = 0.15 
would result in ticks measuring 0.3 centimetres plotted to the inside of the Y-axis 
and sub-ticks measuring 0.15 centimetres plotted to the outside of the X-axis. 
This is illustrated in Figure 7.14(b). 
NOXAXIS, NOYAXIS, NOXLINE, NOYLINE, NOXTICS, NOYTICS, NOXSTICS, NOYSTICS 


It is possible to inhibit any part or all of the axes from being plotted using these 
parameters. Their effects are as follows: 


NOXAXIS switches off X-axis, including ticks and labels 
NOYAXIS switches of Y-axis, including ticks and labels 
NOXLINE switches off X-axis line 

NOYLINE switches off Y-axis line 

NOXTICS switches off ticks along X-axis 

NOYTICS switches off ticks along Y-axis 

NOXSTICS switches off sub-ticks along X-axis 

NOYSTICS switches off sub-ticks along Y-axis 


Labelling Axes 


By default, a label will be plotted for each major tick along the axes (see above under 
‘Units of Measurement’). Several other parameters are useful in controlling the 
labelling of axes. 


XLABHT, YLABHT 
These parameters specify the size or height of text for labels. For example: 


XLABHT = 0.4 YLABHT = 0.2 
Values are expressed in centimetres and the default setting is 0.3 centimetres. 


XLABELS, YLABELS 
These parameters allow the user to specify labels explicitly. 
Figure 7.3 illustrates the use of XLABELS. 


Labels may be specified in two ways. Firstly, they may be entered as GIMMS 
labels. For example: 


XLABELS = JAN,FEB,MAR,APR,MAY JUN,JUL 


In this case individual labels may be up to 10 characters long but must not 
correspond to an existing parameter name or alias within *GRAPH, *BARGRAPH 
or *SCATTER. 


Alternatively, labels can be specified as strings enclosed by primes (''). For 
example: 


XLABELS = ‘JAN’ ‘FEB’ ‘MAR’ ‘APR’ 'MAY' "JUN' "JUL' 


This method ensures that there is no conflict between labels and parameter 
names. Note also that the only characters allowed to be used are the uppercase 
letters A-Z, the digits 0-9 and the full stop character. 


If insufficient labels are specified with relation to the number of ticks on the axis, 
the last label will be repeated. For example: 


*GRAPH DATA = 35,54,67,59,72,79.5,86 
XUNITS = 1 
XLABELS= ‘JAN' ‘FEB’ ‘MAR’ 
‘APR’ MAY ‘JUN’ JUL’ 
YMIN= 25 YMAX= 100 YUNITS= 25 
YLABELS= ‘LOW’ 'MED' ‘HIGH’ 


Output from this command is illustrated in Figure 7.15. The label ‘HIGH’ is 
repeated on the Y-axis as four labels should have been specified according to the 
values for YMIN, YMAX and YUNITS. 


Labels may be up to 10 characters long and their height may be controlled using 
the parameters XLABHT and YLABHT. It is the users responsibility to ensure that 
labels do not overlap or extend beyond the plotting window. 


Titles 


Main titles and sub-titles for axes may be specified by the user. Positions for 
these are determined automatically. The main title is centred on the X-axis and 
positioned so as to allow sufficient space for the Y-axis title; the X-axis title is 
also centred on the X-axis, but is plotted below the axis and its associated ticks 
and labels; the Y-axis title is plotted above the Y-axis. 


TITLE, XTITLE, YTITLE 
These parameter supply text for titles. For example: 
TITLE = ‘Production of GNUMPHS' 
YTITLE = ‘Thousands’ 
XTITLE = ‘Years’ 


Text for titles must be enclosed by primes ("’). 


TITLEHT, XTITLEHT, YTITLEHT 


These parameters are used to specify the height of text appearing in titles. For 
example: 
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TITLE = ‘Production of GNUMPHS' 


TITLEHT = 0.5 
YTITLE = ‘Thousands’ 
TITLEHT = 0.2 


Values are expressed in centimetres. 


The default setting for TITLEHT is 0.4 centimetres and for XTITLEHT and 
YTITLEHT 0.3 centimetres. 


FONT 


This parameter selects the alphabet style to be used when plotting the main 
TITLE. The styles available are illustrated in Appendix B. 


Producing a Key 


The command *TEXT may also be used to supply text for graphs (see Section 6.1.3.4) 
and in particular, can be used to generate a key. 


The commands *GRAPH and *BARGRAPH incorporate preset values for the position 
and size of titles (see above under ‘Titles'). In addition, a text position is defined to the 
right of each data line for a line graph and to the right of the middle point of the final 
bar forabar graph. These positions are accessed using the command *TEXT KEY. 


KEY = 1 selects the position to the right of the first line or bar; KEY = 2 selects the 
position to the right of the next line or bar, and so on. 


The effect of this facility is illustrated in Figure 7.4. The command: 


*TEXT KEY = 1 ‘U.K.’ ALPHABET = 62 / 
KEY = 2 'Rest of World’ 


positions the text 'U.K.' and ‘Rest of World’ at the pre-defined positions relative to the 
bar graph. 
Line Graphs Displaying Single Variables 


There are a number of parameters available to control the way in which values are 
portrayed on line graphs. Different types of symbolism are illustrated in Figure 7.16. 


LINETYPE 


This parameter specifies the line type to be used when plotting the data line. 
For example: 


*GRAPH....LINETYPE = 9 


would select line type number 9. Output from this command would be similar to 
Figure 7.16(a). 


The different line types available are discussed in Section 6.1.3.18. 


PEN 


This parameter may be used to select the pen type or colour. For example: 
*GRAPH....PEN= 3 
would select pen number 3. 


Pen types and colours are discussed in Section 6.1.3.16. 


THICK 


This parameter may be used to vary the thickness or width of the data line. It 
results in the line being redrawn a specified number of times with a small shift 
applied between each redraw. This is similar to the parameter REPEAT in the 
command *TEXT (see Section 6.1.3.4). For example: 


*GRAPH.... THICK =5 


would result in the data line being redrawn 5 times. Output from this command 
would be similar to Figure 7.16(b). 


N.B. Asthe data line approaches the vertical its width will vary. 
An alternative method to thicken the data line is to select a pen with a wider nib 


using the parameter PEN (see above). Users should consult their local computer 
advisor to ascertain if this is possible at their particular site. 


SYMBOL 


This parameter may be used to plot a selected symbol at each point on the data 
line. The symbol is specified by the command *SYMBOLISM SYMBOL (see 
Section 6.1.3.7). Forexample: 


*SYMBOLISM SYMBOL ALPHABET = 3 CHARACTER = 57 
*GRAPH....SYMBOL 


would result in a small square being plotted at each data point (see Figure 
7.16(c)). 


In practice, any symbol defined within the command *SYMBOLISM SYMBOL may 
be selected. For example: 


*GRAPH....SYMBOL= 5 


would plot the symbol defined for level 5. 


SHADE 


This parameter is used to shade the area beneath the data line. For example: 


*GRAPH....SHADE 
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By default, shading level 20 is used and this is defined as solid black (see Figure 


7.16(d)). It may be respecified however, using the command *SYMBOLISM AREA 
LEVEL = 20 (see Section 6.1.3.7). 


In practice, the parameter SHADE may select any shading level defined by the 
command *SYMBOLISM AREA. For example: 


*GRAPH....SHADE = 3 


would select shading level 3. 


VARYX 


This parameter permits the X values in a line graph to vary in preference to 
allocating one value for each tick. 


VARYX generates what is effectively a ‘joined-up' scattergram or, more 
accurately, aline graph with independently variable axes. For example: 


*“GRAPH DATA= 0, 30 
2,15 
9, 30 
12,15 
GROUP = 2 VARYX 
XMIN= 0 XMAX= 12 XUNITS= 3 
YMIN= 0 YMAX = 40 YUNITS= 5 
PEN = 3 


This command would generate a graph with the data line beginning at the point 


(0, 30), passing through the points (2, 15) and (9, 30), and terminating at the 
point (12, 15). The value for GROUP must be set to 2. 


More than one line may be plotted on the graph. In the case of two lines, the 
value for GROUP is set to 4. 


Highlighting Parts of the Data Line 


It may be useful to highlight specific parts of the data line using different line types, 
pen types or colours. 


VAL2, VAL3, LTYPE2, LTYPE3, PEN2, PEN3 


The following command generates the graph illustrated in Figure 7.17(a). 
Default settings are used for line type and pen: 


*GRAPH 
DATA = 35,54,67,59,72,79,86,63,71,76,85,98, 
XMIN = 1970 XUNITS = 5 


The linetype may be changed to a dashed line at the value 1978 by including the 
following parameters: 
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*GRAPH 

DATA = 35,54,67,59,72,79,86,63,71,76,85,98, 
XMIN = 1970 XUNITS= 5 

LINETYPE = 9 VAL2= 1978 


Output from this example is illustrated in Figure 7.17(b). 


The data line may be partitioned into a maximum of 3 parts. For example: 


*GRAPH 

DATA = 35,54,67,59,72,/9,86,63,71,76,85,98, 
XMIN = 1970 XUNITS= 5 

LINETYPE = 5 

LTYPE2 = 0 VAL2= 1973 

LTYPE3 = 9 VAL3 = 1978 


Output from this command is illustrated in Figure 7.17(c). The first part of the 
line is plotted using linetype 5. At the value 1973 it changes to linetype 0 (solid) 
and at the value 1978 it changes again to linetype 9. 


The parameters PEN, PEN2 and PEN3 may also be used in the same way to change 
the pen type or colour for different parts of the data line. 


N.B. These parameters only apply to line graphs displaying single variables. 
The parameter OVERLAY would be required to apply these techniques to 
multi-variable line graphs. 


Line Graphs Displaying Multiple Variables 


Several parameters are available to control symbolism when multiple variables are 
being displayed ona line graph. 


Figure 7.18(a) illustrates a multi-variable line graph. It was generated using the 
command: 


*GRAPH 

GROUP = 2 

DATA = 28,7 47,7 63,4 50,9 67,5 70,9.5 75,11 
YMIN= 0 YMAX = 100 


In this case, two variables are displayed (GROUP = 2) and data values are input in pairs 
to record each variable in turn. 
ADDITIVE 
This parameter generates an additive line graph, where variables are added 
together to produce a series of incremental data lines. The top line represents 


the sum of the values. 


An example of an ADDITIVE line graph is illustrated in Figure 7.18(b). 
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LINEGRP, PENGRP, THICKGRP, SYMBGRP, SHADEGRP 


These parameters define the symbolism to be used for each variable in a multi- 
variable line graph. For example: 


*GRAPH 

GROUP = 2 

DATA= 28,7 47,7 63,4 50,9 67,5 70,9.5 75,11 
ADDITIVE 

YMIN = 0 YMAX = 100 

LINEGRP = 9,5 THICKGRP = 0,5 


In this example, two variables are represented. The first is plotted using linetype 
9 and line thickness 0 (i.e. no repeats), while the second Is plotted using linetype 
5 and line thickness 5 (i.e. 5 repeats). Output from this command is illustrated in 
Figure 7.18(c). 


The parameter SHADEGRP may be used to shade the areas beneath the data 
lines. For example: 


*GRAPH 

GROUP = 2 

DATA = 28,7 47,7 63,4 50,9 67,5 70,9.5 75,11 
ADDITIVE 

YMIN= 0 YMAX= 100 

SHADEGRP = 3,5 


allocates shading level 3 to the first variable and shading level 5 to the second 
variable. Shading level 3 therefore appears between the line representing the 
first variable and the X-axis, and shading level 5 is plotted between the data 
lines. Output from this example is illustrated in Figure 7.18(d). 


N.B. When SHADEGRP is being used with multi-variable line graphs, the 
results will be undefined if the lines cross and SHADEGRP Is therefore 
used primarily with ADDITIVE line graphs. 


SYMBGRP and PENGRP may be used in the same way to define different symbols 
and pen types or colours for each variable. 


Bar Graphs with Multiple Variables 


Several parameters are available to control the appearance of multi-variable bar 
graphs. For example: 


*BARGRAPH GROUP = 2 
DATA = 28,7 47,7 63,4 50,9 67,5 70,9.5 75,11 
YMIN = 0 YMAX = 100 
GAPFRAC = 0.3 SHADEGRP = 3,5 


would plot two sets of bars as a result of the parameter GROUP = 2. Output from this 
example is illustrated in Figure 7.19(a). 
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ADDITIVE 


This parameter adds the second variable to the first (see Figure 7.19(b)). A 
maximum of 20 variables may be represented in this way. 


FLOATING 


This parameter results in the first variable forming the base of the bar and 
subsequent variables being stacked on top (effectively FLOATING ADDITIVE). An 
example is illustrated in Figure 7.19(c). Note that the data values are not the 
same as for the other bar graphs in Figure 7.19. 


SCALED 


This parameter results in each part of the bar being scaled with respect to the 
maximum bar size (i.e. from YMIN to YMAX). An example is illustrated in Figure 
7.19(d). Care should be taken with this parameter as it distorts the values 
represented. 


LINEGRP, PENGRP, SHADEGRP 


GRP parameters may be used to specify symbolism patterns for each bar. For 
example: 


SHADEGRP = 3,5 


would result in the first bar being shaded using symbolism level 3 and the 
second being shaded using symbolism level 5 (see Figure 7.19(a), (b) and d)). 


Scattergrams 


Scattergrams are fundamentally different from line and bar graphs in that two sets of 
X and Y values are plotted against each other. The parameter GROUP is therefore 
always set to 2. In addition, there is no fixed relationship between the order of the X 
values and the X-axis. 


When generating scattergrams the X-axis may be defined in a manner similar to the 
Y-axis for line or bar graphs. For example: 


*SCATTER 
DATA = 28,7 47,7 63,4 50,9 67,5 70,9.5 75,11 
XMIN = 0 XMAX= 100 YMIN= 0 YMAX= 12 


generates the scattergram illustrated in Figure 7.20(a). By default, a small cross symbol 
is plotted at each data points. 
SYMBOL 


This parameter specifies the symbol to be used to mark data points on 
scattergrams. For example: 
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*SYMBOLISM SYMBOL ALPHABET = 3 CHARACTER = 57 
*SCATTER 
DATA = 28,7 47,7 63,4 50,9 67,5 70,9.5 75,11 
XMIN = 0 XMAX = 100 YMIN= 0 YMAX= 12 
SYMBOL 

would produce the scattergram illustrated in Figure 7.20(b). 


The command *SYMBOLISM SYMBOL is discussed in Section 6.1.3.7 


Frequency Histograms 
Instead of representing each value by a single bar, it is possible to produce a frequency 


histogram to count the occurrence of values falling within certain class intervals. This 
technique is particularly useful when data is provided using the parameter VARIABLE. 


FREQ 


This parameter selects a frequency histogram and defines the number of classes. 
For example: 


*BARGRAPH 
DATA = 35,54,67,59,72,79,86,63,71,76,85,98 
FREQ = 4 
would produce a bar graph with 4 classes (FREQ = 4) similar to Figure 7.21. 


The default setting for FREQ is 10 and the maximum value permitted is 100. 


CLASSES 
This parameter is usually used from within the *PLOTPROG module and is used in 
combination with FREQ. The value for FREQ is set by *LEVELS and the frequency 
classes by *INTERVALS (see Section 6.1.3.6). For example: 


*PLOTPROG 


*LEVELS = 3 


“INTERVALS VARIABLE = POP 
USER = 54000, 90000, 140000, 180000 


*BARGRAPH SAMEPAGE 
VARIABLE = POP 
SHADE FREQ CLASSES 


would produce a frequency histogram similar to Figure 6.2 where each class in 
the histogram refers to one shading level on the map. 
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Overlaying Data Variables 
It is sometimes useful to overlay one variable with another. For example: 


*GRAPH 
DATA = 28,47,63,50,67,/0,75 YMIN= 0 YMAX= 100 NOXLAB 
/QVERLAY DATA = 7,7,4,9,5,9.5,11 LINETYPE = 9 


Output from this command is illustrated in Figure 7.22. The slash (/) is used to 
separate variables. 


OVERLAY 


When this parameter is specified, no axis information will be plotted and values 
for XMIN, XMAX etc. will be retained from the previous overlay. It is important 
therefore, that when these values are set, account is taken of the distribution of 
all the data variables being represented. 


NBARS, BARNO 


When OVERLAY ts being used, the system does not know how many overlays will 
follow. However, when multiple bars are being produced side by side the 
parameter NBARS is used to specify the number of overlays (e.g. NBARS = 2) and 
BARNO to identify which one is currently being plotted (e.g. BARNO= 1 or 
BARNO = 2). For example: 


*BARGRAPH DATA.... 
NBARS = 2, BARNO = 1 
/ OVERLAY DATA=.... 
NBARS = 2, BARNO = 2 


Plotting Grids 
Grids may be plotted on top of graphs to assist the user in reading values. 
XGRID, YGRID 


These parameters set the increment for the grid on the X and/ or Y-axes in terms 
of the data values. For example: 


*GRAPH 

DATA = 35,54,67,59,72,79,86,63,71,/6,85,98 
XMIN = 1970 XUNITS = 1 YMIN= 0 YMAX= 100 
XGRID= 5 YGRID= 20 


would produce the graph illustrated in Figure 7.23(a). A 5 unit increment is used 
along the X-axis (i.e. XGRID = 5) and a 20 unit increment along the Y-axis (i.e. 
YGRID = 20). 
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XGMIN, XGMAX, YGMIN, YGMAX 


These parameters may be used to restrict the grid to a specified area within the 
graph. This facility can be useful to mark baselines or ‘trigger values. For 
example: 


*GRAPH 

DATA = 35,54,67,59,72,79,86,63,71,76,85,98 
XMIN = 1970 XUNITS= 1 YMIN= 0 YMAX= 100 
YGRID = 10 YGMIN = 50 YGMAX = 70 


would produce the ‘grid’ illustrated in Figure 7.23(b), where Y values equal to 
50, 60 and 70 have been highlighted. 


If values for XGMIN and XGMAX (or YGMIN and YGMAX) are the same, a single 
line will be plotted. For example: 


*GRAPH 

DATA = 35,54,67,59,72,79,86,63,7 1,76,85,98 
XMIN = 1970 XUNITS = 1 YMIN= 0 YMAX = 100 
YGRID = 1 YGMIN = 60 YGMAX = 60 


would produce the graph illustrated in Figure 7.23(c), where the Y value equal to 
60 is marked by a horizontal line. 


XGPEN, YGPEN, XGLTYPE, YGLTYPE 


These parameters select the pens and line types to be used to plot the grid. For 
example: 
*GRAPH 
DATA = 35,54,67,59,72,79,86,63,71,76,85,98 
XMIN = 1970 XUNITS = 1 YMIN= 0 YMAX = 100 
XGRID = 2 XGLTYPE = 5 YGRID= 20 YGLTYPE= 9 


would produce the graph illustrated in Figure 7.23(d). Line type 5 Is used to plot 
the XGRID (i.e. XGLTYPE= 5) and line type 9 is used to plot the YGRID (i.e. 
YGLTYPE = 9). 

Pen types and line types are discussed in Section 6.1.3.16 and Section 6.1.3.18 
respectively. 


GRID 


lf this parameter is specified, grid increments will be automatically set to the 
same values as XUNITS and YUNITS. 


Plotting Data Values on Bar Graphs 
BARTEXT, TOP, MIDDLE, BOTTOM 
It is possible to plot data values on bar graphs at several pre-defined locations. 


For example, in Figure 7.3 values are plotted at the top of each bar using the 
parameters: 


BARTEXT = TOP 


If the parameters BARTEXT = MIDDLE had been selected, values would have 
been plotted midway along each bar. 


If the parameters BARTEXT =BOTTOM had been selected, values would have 
been plotted below each bar. In this case, the parameter NOXLABEL would also 
be required. 

When multiple bars are being plotted using the parameter ADDITIVE, 


BARTEXT = MIDDLE is generally selected as TOP and BOTTOM would result in 
most of the values being plotted outside the bars to which they refer. 


BIEXTHT, BIEXTAFT 


The height of values plotted by BARTEXT is set by the parameter BTEXTHT. The 
default setting is 0.3 centimetres. 


The number of digits plotted after the decimal point is set by the parameter 
BTEXTAFT. The default setting is 0. 

BITEXTGRP 
BARTEXT will generally result in values being plotted for every bar in a multiple 
group. However, the parameter BTEXTGRP may be used to specify explicitly 


which bars are to be labelled. 


For example, the following parameters may be used to plot values for the first 
and fourth parts of an ADDITIVE bar: 


BARTEXT = MIDDLE BTEXTGRP = 1,0,0,1 


The presence or absence of a value is indicated by a 1 (presence) or 0 (absence). 


BARTOTAL 
When an ADDITIVE bar graph is being generated, the parameter BARTOTAL will 
result in the sum of the values for each set of bars being plotted at the top of the 
bars. 


In addition, BARTOTAL may be used to specify the number of digits to be plotted 
after the decimal point. For example: 


BARTOTAL= 2 


would plot 2 digits after the decimal point. 


Miscellaneous Parameters 


LINE, BAR, SCATTER 


These parameters override the commands *GRAPH, *BARGRAPH, or *SCATTER. 
For example *GRAPH BAR is equivalent to *BARGRAPH. 


INSET, OFFSET 


These parameters may be used to indent the start position for the data line when 
defining aline graph. For example: 


*GRAPH....INSET = 0.2 
would indent the data line 0.2 centimetres from the Y-axis (see Figure 7.24). 


The parameter OFFSET results in data points being plotted between the tick 
marks on the X-axis. 


XVALUES 


Generally the number of values are represented along the X-axis and measured 
along the Y-axis. The parameter XVALUES may be used however, to reverse this 
condition. For example: 


*BARGRAPH 

DATA = 28,7 47,7 63,4 50,9 67,5 70,9.5 75,11 
XVALUES YMIN = 1976 YUNITS = 1 

XMIN= 0 XMAX= 100 SHADEGRP = 3,5 


would produce a horizontal bar graph. 


7.2.0.0 *PIE COMMAND 


This command produces pie charts. It is different from the commands *GRAPH, 
*BARGRAPH, and *SCATTER in that a *NEWMAP or *NEWPAGE command must be 
used to specify the dimensions of the plotting window. For example: 


*NEWPAGE 18,24 FRAME 
*PIE DATA = 35,54,67,59,72,79 


would produce Figure 7.25. 
By default *PIE, plots the pie chart in the centre of the plotting window and the size of 


the pie is related to the size of page. Examples of pie charts are illustrated in Figures 
6.9,6.10, and 7.26. 


Within *PIE the following parameters are available: 
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XCENTRE (X) (CENTRE) (CENTER) 
/R,:P, =(C:NEWPAGE)/ specifies X coordinate for centre of 


pie 
YCENTRE (Y) /R,:P, =(C:NEWPAGE)/ specifies Y coordinate for centre of 
pie 
BASE (START) /R, = 90/ specifies start angle 
DEGREES /R = 360/ specifies number of degrees for pie 
RADIUS (R) (SIZE) /R, = (C:NEWPAGE)/ specifies radius in centimetres 
DATA (D) /R,REPEAT = 20/ specifies data values for each sector 
PENTYPE (PENS) /A,REPEAT = 20/ lists pen types or colours for each 
sector 
LINETYPE /\,REPEAT = 20/ lists line types for each sector 
SHADING [A,REPEAT = 20/ lists shading levels for each sector 
GROUP (G) /,REPEAT = 20/ ‘explodes’ sectors 
SHADE /K/ selects default shading 
DEFAULTS (RESET) /K/ resets default values 


Further Notes on *PIE Parameters 
DATA 


This parameter is used to specify data values for a pie chart. The complete pie 
represents the sum and each sector is scaled to depict individual values. 


A maximum of 20 values may be supplied for a pie chart. 


XCENTRE, YCENTRE, RADIUS 


These parameters define the position and size of the pie chart within the 
plotting window. All values are expressed in centimetres. For example: 


*PIE XCENTRE = 3 YCENTRE = 21 RADIUS = 2 
DATA = 5,5,5,5,5 


This command generates the pie chart illustrated in Figure 7.26(a). 


BASE 
By default, the pie chart is plotted in a clockwise direction from a start position at 
90 degrees. An alternative start position may be specified using the parameter 
BASE. For example: 

*DIE ..... BASE = 115 

would rotate the pie through 25 degrees anti-clockwise. Output from this 
example is illustrated in Figure 7.26(b). 

DEGREES 


By default the pie chart extends through 360 degrees. The parameter DEGREES 
may be used to limit the extent of the pie. For example: 
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PUG cosz; DEGREES = 270 


would limit the pie to 270 degrees. Output from this example is illustrated in 
Figure 7.26(c). 


PENTYPE, LINETYPE 


These parameters may be used to plot the outlines of pie sectors using different 
pen types/ colours and line types. For example: 


gs od | cee LINETYPE = 0,3,8,14,6 


Output from this example is illustrated in Figure 7.26(d). The first sector is 
plotted using line type 0, or solid, the second using line type 3, the third using 
line type 8, and soon. 


The different line types available are illustrated in Figure 6.13. In addition, the 
command *SETLINES may be used to define other line types (see Section 
6.1.3.18). 


Similarly the outline of each sector may be plotted using different pen types or 
colours. For example: 


TIPU E 22. PENTYPE = 1,3,2,4,3 


The first sector is plotted using pen 1, the second using pen 3, the third using pen 
2,and soon. 


Users should consult their local computer advisor to ascertain which pen types 
and colours are available and how they are coded. 


SHADE, SHADING 


These parameters may be used to shade each pie sector using area patterns such 
as crosshatch, dot screens etc., specified by the command *SYMBOLISM AREA 
(see Section 6.1.3.7). 


If the parameter SHADE is issued, sector 1 will be shaded using symbolism level 1, 
sector 2 using symbolism level 2, sector 3 using symbolism level 3, and so on. For 
example: 

soa | ee SHADE 
Output from this example is illustrated in Figure 7.26(e). In this case, the default 
shading patterns for *SYMBOLISM AREA are plotted. 


The parameter SHADING may be used to specify which shading level is to be 
allocated to each sector. For example: 


* PEE seco: SHADING = 4,1,3,5,2 


would allocate shading level 4 to the first sector, shading level 1 to the second 
sector, shading level 3 to the third sector, and so on. Output from this example ts 
illustrated in Figure 7.26(f). 

GROUP 
This parameter may be used to ‘explode’ pie sectors. For example: 


* PLE sea GROUP = 0,0,1,0,0 


Output from this example is illustrated in Figure 7.26(g). The third sector is 
displaced as it belongs to group 1 while the other sectors belong to group 0. 


Sectors which are adjacent and have the same group value will be joined. All 
slices with a group value greater than zero will be exploded from the central 
point. For example: 

PVE cone: GROUP = 0,1,1,2,0 
Output from this example is illustrated in Figure 7.26(h); 

| ae GROUP = 1,2,3,4,5 
Output from this example is illustrated tn Figure 7.26(i); 


PLE Ac GROUP = 0,1,0,1,0 


Output from this example js illustrated in Figure 7.26(j). 


DEFAULTS 


This parameter may be used to reset all default values. 
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SECTION 8: *MANIPULATE APPLICATION MODULE 


CONTENTS 


THE *MANIPULATE APPLICATION MODULE 


8.0.1.0 Commands Available 


*AGGREGATE COMMAND 
*COMPUTE COMMAND 

*CONVGRID COMMAND 

*DELETE COMMAND 

*LOCATE COMMAND 

*SUBSET COMMAND 

*INTERP AND *SMOOTH COMMANDS 


8.0.0.0 THE *~MANIPULATE APPLICATION MODULE 


The *MANIPULATE Application Module incorporates a number of facilities to 
manipulate GIMMS locational and non-locational data files after they have been 
created by *FILEIN (see Section 4). For example, new variables may be computed, 
geographic searching routines applied and data subsets extracted. 


The *MANIPULATE Application Module may be accessed directly from the Main 
Control Program: 


<Commands available from the Main Control Program > 


*MANIPULATE <to access the *~MANIPULATE module > 
<Commands available within *~*MANIPULATE > 
*END <to return to Main Control Program > 
*STOP <to terminate the GIMMS command run > 


*MANIPULATE may also be accessed indirectly from the mapping module, *PLOTPROG 
(see Section 6): 


<Commands available from the Main Control Program > 


*PLOTPROG <to access the *PLOTPROG module > 
<Commands available within *PLOTPROG > 


*MANIPULATE <to access the *~MANIPULATE module > 
<Commands available within *~MANIPULATE > 


*END <to return to the *PLOTPROG module > 
<Commands available within *PLOTPROG > 
*END <to return to the Main Control Program > 
*STOP <to terminate the GIMMS command run > 


N.B. On some systems with limited memory, it may not possible to enter 
*MANIPULATE from the *PLOTPROG module. Users experiencing difficulty 
should consult their local computer advisor. 


8.0.1.0 Commands Available 


The following commands are available within the ~MANIPULATE module: 


*AGGREGATE aggregates or sorts non-locational DATA files 
*CALL accesses a GIMMS macro 

*COMPUTE computes new non-locational data variables 
*CONVGRID converts non-locational DATA file to GRID file 
*DELETE deletes a variable from anon-locational DATA file or GRID file 
*END returns control to the Main Control Program 
*FILEINFO prints information about GIMMS data files 
*INTERP interpolates a GRID file variable 

*LOCATE defines geographic searching procedure 
*SMOOTH smoothes a GRID file variable 

*SUBSET creates subsets from GIMMS data files 

*USER accesses a user supplied subroutine 
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*UTILITIES accesses *UTILITIES Application Module 


The command *FILEINFO ts described in Section 3.3.3.4, while *UTILITIES and *CALL 
are described in Section 9. The remaining commands are discussed below. 


8.1.0.0 *~AGGREGATE COMMAND 


This command aggregates non-locationa! data into larger units on the basis of zone- 
Indices. 


The following example describes how *~AGGREGATE may be used: 


In Scotland there is a two tier system of Local Government. The upper tier consists of 
Regional Councils, while the lower tier consists of District Councils. 


To reflect this situation, a zone-index could be used to identify which particular 
Districts belonged to each Region. A non-locational DATA file for Districts would 
then incorporate a variable listing zone-index numbers. For example, the value 5 may 
be allocated to Lothian Region and this value would appear in the zone-index variable 
for those Districts belonging to that Region. Using the zone-index variable, data for 
Districts could be *~AGGREGATEd to form a data set for Regions. 


Within *AGGREGATE the following parameters are available: 


VARIABLE /\/ specifies Aggregate Variable number 
VARNAME /L/ specifies Aggregate Variable name 
AREAVAR /\/ specifies Area Variable number 


AVARNAME iL! specifies Area Variable name 


Within an *AGGREGATE command an Aggregate Variable and a Area Variable MUST 
be specified. These variables may be identified by their position in the non-locational 
DATA file (using the parameters VARIABLE and AREAVAR) or by their name (using the 
parameters VARNAME and AVARNAME). For example: 


*AGGREGATE VARIABLE = ZINDEX, AREAVAR = 3 


would select the variable called ZINDEX as the Aggregate Variable and the variable 
stored at position 3 in the non-locational DATA file as the Area Variable. 


The Aggregate Variable represents a zone index value while the Area Variable ts a 
variable used to control aggregation. This is usually a variable indicating size of some 
sort, suchas SURFAREA (see Section 9.2.0.0). 


N.B. Both the Aggregate Variable and the Area Variable MUST already existin the 
non-locational DATA file. 


When *AGGREGATE is used, two new variables called AGGZONES and MAXAREA will 
be created in the non-locational DATA file. AGGZONES will contain the number of 
zones aggregated to form each new zone, while MAXAREA will contain the maximum 
value of the Area Variable used to create each new zone. 


N.B. There MUST be enough space in the non-locational DATA file to store these 
new variables. 


Variables are aggregated in different ways depending on how they were defined by 
*FILEIN (see Section 4.3.2.0). Values for ABSOLUTE variables are added together to 
form a new total for the larger zone; values for DENSITY variables are combined with 
the Area Variable for each sub-zone to form a weighted average (see below under 
‘Further Notes on the Area Variable’). 


Further Notes on the Aggregate Variable 


Values for an Aggregate Variable should be a series of integer numbers less than or 
equal to the number of ZONES in the non-locational DATA file. If not, the following 
error message will be printed and the command aborted: 


AGGREGATE/SORT VALUE OUTSIDE RANGE 


For example, if anon-locational DATA file contains 10 zones, the following values may 
be allocated to a variable called INDEX: 


Zone number 1 2 3 4 5 6 7. 8 9 10 
Value for INDEX 3 1 1 4 2 3 4 1 2 1 


N.B. Values for the variable INDEX should be integer numbers; if a real number is 
input it will be truncated e.g. a value of 6.7 will be processed as 6. 


When aggregation occurs using the command: 
* AGGREGATE VARIABLE = INDEX AREAVAR = 


zones numbered 1 and 6 will form the new zone 3; zones numbered 2, 3, 8 and 10 will 
form the new zone 1; zones numbered 4 and 7 will form the new zone 4: and zones 
numbered 5 and 9 will form the new zone 2. 


The resulting DATA file will over-write the existing DATA file and will contain all the 
original variables but their values will be aggregated as appropriate to form the four 
new zones. In addition, there will be two new variables, AGGZONES and MAXAREA. 


New Zone Zones Value of Value of 
Number Aggregated AGGZONES INDEX 
1 2,3,8,10 4 4 
2 5,9 2 4 
3 1,6 2 6 
4 47 2 8 


‘ 


The value for AGGZONES contains the number of original zones aggregated to form 
the new zones. Values for the variable INDEX have also been aggregated on the basis 
of these new zones. The variable MAXAREA 1s discussed below (see ‘The Results of 
Aggregation ). 


N.B. Prior to aggregation, values for new zone variables are automatically set to 
zero (0). If anew zone does not contain any of the original zones, zero values 
will remain. 


Further Notes on the Area Variable 

The Area Variable MUST be supplied as it is used to control the method of aggregation 
for DENSITY and ALPHA/NOMINAL variables. This is described below. 

The Results of Aggregation 


The method of aggregation used depends on how variables were originally defined 
when they were input using *FILEIN (see Section 4.3.2.0). 


To demonstrate the effect of aggregation, a non-locational DATA file containing 10 
zones has been defined. When the DATA file is aggregated, zones 2, 3,8 and 10 will be 
combined to form one of the new zones. 


Variables present in the DATA file include: 


Variable Variable Description 
Name Type 

ZONENAME ALPHA/NOMINAL name of zone (e.g. 202) 

SURFAREA ABSOLUTE surface area (e.g. 57.3) 

POP ABSOLUTE population (e.g. 2015) 

PERCAR DENSITY percentage of households with a CAR 

(e.g.15.2) 
INDEX ABSOLUTE Aggregate Variable (e.g. 1) 


Values recorded for zones 2, 3,8 and 10 are as follows: 


Zone ZONENAME SURFAREA POP PERCAR INDEX 
2 Z02 32. 5962 15.2 1 
3 203 68.7 2756 6.3 ] 
8 Z08 96.3 4319 8.9 1 
10 710 45.4 3827 4.2 1 


Aggregation is performed using the command: 


*AGGREGATE VARIABLE = INDEX AREAVAR = SURFAREA 


The new zone created by combining the original zones 2, 3, 8 and 10 will contain the 
following values. 


Zone ZONENAME SURFAREA POP PERCAR INDEX AGGZONES MAXAREA 


1 208 242.5 16864 8.12 4 4 96.3 


These values have been calculated as follows: 


ZONENAME 


This variable was defined as ALPHA/NOMINAL and aggregation is therefore 
nonsensical. The result stored after aggregation is the ZONENAME of the zone 
with the largest value for the Area Variable, SURFAREA i.e. 208. 


SURFAREA, POP, INDEX 


These variables were defined as ABSOLUTE. The result recorded for each 
variable is the sum of the values for the zones being aggregated. 


PERCAR 


This variable was defined as DENSITY. The Area Variable, SURFAREA, is 
therefore used to weight individual values and the result for the new zone is 
calculated as follows: 


(Zone numbers appear in brackets after variable names) 


RESULT = ((PERCAR(2)*SURFAREA(2)) 
+ (PERCAR(3)*SURFAREA(3)) 
+ (PERCAR(8)*SURFAREA(8)) 
+ (PERCAR(10)*SURFAREA(10))/TOTAL(SURFAREA) 


The total SURFAREA for the 10 zones stored in the non-locational DATA file is 
242.5. This value becomes the divisor and the following computation is used to 
aggregate zones 2, 3, 8 and 10: 


((15.2*32.1) + (6.3*68.7) + (8.9%*96.3) + (4.2*45.4) )/242.5 

The result stored for the new zone is 8.12. 

N.B. The Area Variable does not need to be SURFAREA and can be any 
variable. For example, if POP were selected, ‘population weighted’ 
aggregates would be produced for DENSITY variables. 

AGGZONES 
This variable does not exist prior to aggregation. The value stored is equivalent 
to the number of zones aggregated to produce the new zone i.e. 4. 

MAXAREA 

This variable does not exist prior to aggregation. The value stored is equivalent 

to the largest value recorded for the Area Variable, SURFAREA i.e. 96.3. 

If an Aggregate Variable had been used in the *AGGREGATE command instead 


of an Area Variable, for example: 


*AGGREGATE VARIABLE = INDEX AREAVAR = INDEX 


results after aggregation would be as follows: 


Zone ZONENAME SURFAREA POP PERCAR INDEX AGGZONES MAXAREA 

1 undefined 242.5 16864 388.65 4 4 1 
Variables defined as ABSOLUTE produce the same results as before. The variable 
defined as DENSITY (i.e PERCAR) however, has been averaged (i.e. 
((15.2* 1) + (6.3% 1) +(8.9*1)+(4.2*1)) / 4), while the ALPHA/NOMINAL variable 
ZONENAME has produced an ‘undefined’ result. 
Sorting DATA Files Using *~AGGREGATE 


*AGGREGATE may also be used to sort zones within the DATA file. For example, if the 
following values for INDEX were input for each zone: 


Zone number 1 2 3 4 5 6 7. 8 9 10 
Value of INDEX 7 4 3 #610 2 ] 9 5 6 8 


the command: 
*AGGREGATE VARIABLE = INDEX AREAVAR = 


would generate the following results: 


New Zone Old Zones Value of Value of 
Number Aggregated AGGZONES INDEX 
1 6 ] ] 

2 5 1 2 
3 3 ] 3 
4 2 1 4 
5 8 1 5 
6 9 1 6 
7 1 1 vj 
8 10 1 8 
9 7 1 9 
10 4 1 10 


The DATA file has therefore been sorted on the basis of the value for the variable 
INDEX. 


Footnote 
if the user has no knowledge of the type of variables existing in the DATA file, the 
same variable may be used for the Aggregate Variable and the Area Variable. For 


example: 


“AGGREGATE VARIABLE = INDEX AREAVAR = INDEX 


This command would perform an aggregate/sort but may generate misleading values 
for DENSITY and ALPHA/NOMINAL variables. When the DATA file is only being sorted 
however, the variable type does not matter as true aggregation Is not required. 


8.2.0.0 “COMPUTE COMMAND 


This command is used to compute new data variables or change the values of existing 
variables. 


For example, a new variable called POPDEN may be computed by dividing a variable 
called POP by a variable called AREA: 


*COMPUTE POPDEN = (POP/AREA) 
Calculations performed by *COMPUTE may be relatively complex and incorporate 
logical expressions. For example, the following command will create a new variable 
called NEWVAR. This variable is defined as ABSOLUTE and is generated’ by 
multiplying the variable POLCON by a factor dependent on the value of the variable 
PARTY: 


*COMPUTE NEWVAR ABSOLUTE 
IF (PARTY ='LAB') THEN (POLCON*3.2) 
IF (PARTY ='CON') THEN (POLCON* 1.7) 
IF (PARTY = LIB’) THEN (POLCON* 3.4) 
IF (PARTY =‘SDP’) THEN (POLCON*2.8) 
ELSE (POLCON*4.6) 


This command relies on the logical expression IF/THEN. Within a single *COMPUTE 
command a maximum of 50 IF/THEN clauses may be included. 


Within *COMPUTE the following parameters are available: 


VARIABLE (VARNO) (VAR) /\/ specifies variable number 

VARNAME /L/ specifies variable name 

DATAFILE (DATA) /K, = ON/ selects non-locational DATA file 

GRIDFILE (GRID) /K/ selects GRID file 

EXPRESS /E/ specifies expression to be 
evaluated 

IF (FOR) /K,RETURN/ initialises logical condition 

THEN (SET) /K,RETURN/ specifies arithmetic expression 
to be evaluated 

ELSE /K,RETURN/ specifies arithmetic expression 
to be evaluated 

ALLIFS /K,RETURN/ selects the last true IF expression 

PRINT /K/ prints results for each zone 

FULL /K/ prints results for all expressions 
evaluated 

ABSOLUTE (ABS) /K,RETURN/ specifies ABSOLUTE variable 

DENSITY (DEN) /K,RETURN/ specifies DENSITY variable 


Further Notes on *COMPUTE Parameters 
VARNAME, VARIABLE 


The parameter VARNAME may be used to allocate a name to a computed 
variable. For example: 


*COMPUTE VARNAME =POPDEN (POP/AREA) 


The parameter VARIABLE may be used to allocate a position within the non- 
locational DATA file to a computed variable. For example: 


*COMPUTE VARIABLE = 8 (POP/AREA) 


lf a VARNAME is allocated, the DATA file will be examined to establish if the 
variable already exists. If it does, it will be over-written with values for the new 
variable: if it does not, the results will be recorded at the next free variable 
position. 


If a variable is allocated a position using the parameter VARIABLE, the results of 
the computation will be recorded at that position regardless of whether or not a 
variable exists there already. 


N.B. It is recommended that computed variables be added to a DATA file 
using the parameter VARNAME rather than VARIABLE as this reduces the 
possibility of inadvertently over-writing an existing variable. 


Sufficient space must exist within a DATA file to store the newly computed 
variable(s). Extra space may be added using the command “*FILEIN (see Section 
4.3.2.0 under EXTRA). Alternatively, the command *CREATE may be used (see 
Section 9.2.0.0). 


lf a variable name or number is not specified, a variable called TEMPVAR' will be 
created. If avariable already exists with this name, it will be over-written. 


DATAFILE, GRIDFILE 


These parameters specify the type of data file being processed. DATAFILE selects 
a non-locational DATA file of the type described in Section 4; GRIDFILE selects a 
GRID file of the type described in Section 9.2.0.0. GRID files are generally used 
for contour mapping (see Section 6.1.3.3 under ‘Isopleth or Contour Mapping’). 


DATAFILE is the default setting. 


EXPRESS 


This parameter is used to describe the computation. Expressions MUST be 
enclosed by brackets and may comprise variable names, constants, functions and 
arithmetic operators. These different components are described below. 


Variable Names 


Only variables identified by name (and NOT by position) may appear in an 
expression. For example: 


*COMPUTE POPDEN EXPRESS = (POP/AREA) 
where POP and AREA are both variable names. 


If the variables named are not present in the DATA file the following error 
message will be printed: 


**** VARIABLE NAME NOT RECOGNISED - variable name 
Constants 
Any real or integer number may appear in an expression. For example: 
0.3,1, -967.21 


Alphabetic strings are also permitted but MUST not exceed four characters and 
MUST be enclosed by primes (''). For example: 


‘MALE’, 'A129', 'B4', 'C,/:. 
N.B. Primes are not permitted within alphabetic strings. 
Functions 


The following functions may be included tn an expression: 


SQRT Square root 


LOG Logarithms to base e 
EXP Exponential 

SIN Sine 

COS Cosine 

TAN Tangent 

ABS Absolute value 


Arithmetic Operators 


The following arithmetic operators may be included within an expression: 


Symbol Alias Meaning 
+ PLUS addition 
- MINUS subtraction 
‘ TIMES multiplication 
/ UPON division 


oe exponentiation 


Example 


The following expression calculates distance on a Euclidean plane and employs 
variable names, constants, functions and arithmetic operators: 
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*COMPUTE DIST ABSOLUTE 
EXPRESS = (SQRT ( ((E1-E2)**2) + ((N1-N2)**2)) ) 


where E1, N1 and E2, N2 represent the eastings and northings of two points 
between which the DiSTance is being *COMPUTEd. 


N.B. The above expression has used parentheses i.e. (), to control the order tn 
which different parts are evaluated. This order follows FORTRAN 
conventions and the expression within the innermost parentheses is 
evaluated first. It is advisable to include parentheses within expressions 
to reduce ambiguity and to ensure that the different parts are evaluated 
in the correct order. 


IF, THEN, ELSE 
These parameters may be used to incorporate logical conditions into 
computations. These conditions will be either true or false. IF a condition 1s true 
THEN a defined arithmetic expression will be evaluated: if it is false (ELSE) an 
alternative expression will be evaluated. For example: 
*COMPUTE NEWVAR = ABSOLUTE 
IF (VAL < 0) THEN (EMP* 2) ELSE (EMP* 3) 


The following logical operators may be used to define the condition: 


Logical 

Operator Meaning Alternatives 
OR logical OR | 

AND logical AND & 

NOT logical NOT \ 

GT greater than > 

GE greater than or equal to >= Nk 
Bl less than < 

EE less than or equal to <= NG 
EQ equal to = 

NE not equal # 


Examples of Logical Expressions 
EXAMPLE 1 


“COMPUTE COLOUR = DENSITY 
IF (COLVAL EQ‘RED') THEN (1) 
IF (COLVAL EQ 'BLUE’') THEN (2) 

ELSE (3) 


where the computed variable COLOUR would be allocated a value of 1, 2 or 3 
depending on the value of the variable COLVAL. IF COLVAL EQualled RED THEN 
the value 1 would be allocated to variable COLOUR: IF COLVAL EQualled BLUE 
THEN the value 2 would be allocated to variable COLOUR: if COLVAL was neither 
RED nor BLUE (t.e. ELSE), the value 3 would be allocated to variable COLOUR. 
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EXAMPLE 2 


*COMPUTE CREDRATE = ABSOLUTE 
IF(SEX EQ MALE’ AND AGE GT 23) 
THEN (INCOME * 3) 


IF(SEX EQ'MALE’ AND (AGE GT 17 AND AGE LT 23)) 
THEN (INCOME* 1) 


IF(SEX NE MALE’ AND AGE GT 20) 
THEN (INCOME*0.5) 


ELSE (0) 


where the computed variable CREDRATE is allocated the value 3*INCOME, 
1*INCOME, or 0.5*INCOME depending on the values of variables SEX and AGE. 
A value of 0 Is allocated by the ELSE clause to those zones falling outside the 
realms of the IF conditions. 


ALLIFS 


By default, the value computed for a particular zone is determined by the first 
true logical expression. For example: 


*COMPUTE INCLASS = DENSITY 

IF (INCOME < 10000) THEN (1) 

IF INCOME > = 10000 AND INCOME < = 20000) THEN (2) 
IF INCOME > = 20000) THEN (3) 


There ts an overlap in this logical expression between the second and third IF 
conditions i.e. where INCOME equals 20000. If a zone has a value of 20000 
however, the second IF clause is taken as true and the value 2 stored for the 
computed variable INCLASS. 


However, if the parameter ALLIFS is included: 


*COMPUTE INCLASS = DENSITY ALLIFS 

IF INCOME < 10000) THEN (1) 

IF (INCOME > = 10000 AND INCOME < = 20000) THEN (2) 
IF (INCOME > = 20000) THEN (3) 


the third (or final) true IF clause will be used instead and result in a value of 3 
being allocated to the computed variable INCLASS when INCOME equals 20000. 


In the example above, all possible values for the variable INCOME have been 
covered by the three IF clauses and there is no need for an ELSE expression. If 
however a value had fallen outside the realms of the IF conditions, a zero (Q) 
would have been automatically assigned. This is equivalent to including the 
expression: 


ELSE (0) 
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ABSOLUTE, DENSITY 


These parameters describe the type of variable being computed. A description 
of each type Is presented in Section 4.3.2.0. 


The use of these parameters is critical to *AGGREGATE (see Section 8.1.0.0) and 
*CONVGRID (see Section 8.3.0.0). 


If neither of these parameters is specified when a variable is computed, it will be 
of type UNDEFINED’ but will be interpreted as ‘ABSOLUTE’ by *AGGREGATE and 
*CONVGRID. 


PRINT,FULL 


If the parameter PRINT ts specified within *COMPUTE (i.e. *COMPUTE....PRINT), 
values for the new variable will be printed for each zone occurring in the non- 
locational DATA file. 


If the parameter FULL ts specified (i.e. *COMPUTE....FULL), results for IF / THEN 
conditions will be printed together with values for each zone. 


Examples of “COMPUTE 
EXAMPLE 17 


*FILEPARM DATA ‘DATAFILE’ GIMMS 
“MANIPULATE 


“COMPUTE NEWVAR 
IF (POP GT 100) THEN (POP/AREA) ELSE (-999) 


*END 
SLOP 


This GIMMS command run computes a new variable called NEWVAR on the basis 
of values for the existing variable POP. The computed variable will be stored at 
the first available position in the GIMMS non-locational DATA file. 


N.B. In the above example parameter names have been omitted and 
interpretation of the values relies on GPIS (see Section 2.2.2.0) 


EXAMPLE 2 


*FILEPARM DATA DATAFILE'’ 
*MANIPULATE 


*COMPUTE COMMISSION = ABSOLUTE ALLIFS 
IF (SALES > 100000) THEN (SALES/10) 
IF (SALES > 200000) THEN ((SALES*8)/100) 
IF (SALES > 500000 AND LASTYEAR > 500000) THEN (SALES/10) 
ELSE ((SALES* 3)/100) 


*END 
*STOP 
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This GIMMS command run computes COMMISSION on the basis of SALES figures 
for this year and LASTYEAR. The ELSE clause specifies the basic rate of 
commission t.e. 3%. The parameter ALLIFS is required in this example to ensure 
that the correct commission is calculated. 


EXAMPLE 3 


*FILEPARM DATA 'DATAFILE' 
*MANIPULATE 


*COMPUTE RATIO = DENSITY 
IF (RATIO LT 0.5 AND MAXX > MAXY) THEN (MAXY/MAXxX) 
IF (RATIO GE 0.5 AND MAXX < = MAXY) THEN (MAXX/MAXY) 
ELSE (RATIO) 


*END 
*STOP 


This GIMMS command run computes new values for the variable RATIO and 
existing values will be over-written. 


8.3.0.0 *CONVGRID COMMAND 


This command ts used to convert a non-locational DATA file to a GRID file. The DATA 
file MUST be associated with a POINT or polygon file. In addition, the GRID file should 
have been created using the command *CREATE (see Section 9.2.0.0), with sufficient 
space to store the variables transferred from the DATA file. 


*CONVGRID is generally used to transfer point or polygon data to grid data prior to 
*INTERPolation and contour mapping. 


Within *CONVGRID the following parameters are available: 


FILEIN (IN) /\/ specifies channel number for point 
or polygon file 

VARLIST /\, REPEAT = 100/ specifies list of variable numbers 

/L, REPEAT = 100/ specifies list of variable names 

POINT /K/ transfers value from polygon to cell 
using centroid 

DEFAULT /R/ specifies default value if cell does not 
fall within a polygon 

MERGE /K/ merges values with existing variable 


(for POINT mode only) 
Further Notes on *CONVGRID 


Selected variables from the DATA file may be transferred to the GRID file using 
variable numbers or names. For example: 
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*CONVGRID FILEIN = 11 VARLIST = AREA, XCENT, YCENT, POP 


In this example, a polygon file is read from channel 11 (FILEIN= 11), and the non- 
locational DATA variables AREA, XCENT, YCENT, POP are transferred to the GRID file. 


Variables are transferred to the GRID file in different ways depending how they were 
originally defined: 


Variable 
Type Method of Transfer to GRID file 
ABSOLUTE The value for each cell is the value for the polygon divided 
by the number of cells. For example, if the value for a 
polygon ts 90 and it contains three cells, the value allocated 
to each cell will be 30. 
DENSITY The value for each cell is the same as the polygon. For 


example, if the value for the polygon is 90 and it contains 
three cells, the value allocated to each cell will be 90. 


ALPHA/NOMINAL 


The value for each cell is the same as the polygon. For 
example, if the value for the polygon is ‘201 and it 
contains three cells, the value allocated to each cell will be 
‘ZO. 


Locating Values in the GRID File 


If the mid-point of a grid cell lies within a polygon, the selected variables are 
disaggregated (i.e. copied, with possible modifications depending on the variable 
type) from the DATA file to the appropriate location in the GRID file. 


If a grid cell is NOT located within a polygon, its value will be defined by the 
parameter DEFAULT. 


When a polygon file is being used, grid cells falling within the study area will generally 
be assigned a value. if however, the parameter POINT is specified, only the cells 
containing polygon centroids will be assigned values; the remaining cells will be 
assigned the DEFAULT value. Thisisinitially set to zero (0). 

POINT mode is generally selected when *INTERPolation is required to facilitate 
contour mapping (see Section 8.7.0.0). 


In addition, if the parameter MERGE is specified, values for cells containing more than 
one centroid will be averaged. MERGE Is only valid when POINT has been selected. 
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Examples of *CONVGRID 


EXAMPLE 1 


*FILEPARM 11 ‘POLYGONS’ GIMMS 
*FILEPARM DATA ‘DATAFILE’ GIMMS 
*FILEPARM GRID ‘'GRIDFILE’ GIMMS 


*MANIPULATE 
*COMPUTE POPDEN = DENSITY 


(POP/AREA) 
*CONVGRID FILEIN = 11 VARLIST = POP, AREA, POPDEN 
*END 
*STOP 


In this GIMMS command run, the polygon, DATA and GRID files are assigned 
using the command *FILEPARM (see Section 3.3.1.2). The *COMPUTE command 
creates a new variable called POPDEN, while the *CONVGRID command reads 
the polygon file from channel 11 and lists the variables to be transferred from 
the DATA file to the GRID file. 


EXAMPLE 2 
*FILEPARM 11 ‘POLYGONS' GIMMS 
*FILEPARM DATA 'DATAFILE' GIMMS 
*FILEPARM GRID 'GRIDFILE’ GIMMS 
*MANIPULATE 


*CONVGRID FILEIN = 11 VARLIST = RAINFALL, HEIGHT 
POINT MERGE DEFAULT = 0 


*END 
*STOP 


In this GIMMS command run, variables RAINFALL and HEIGHT are transferred to 
the GRID file but only for those cells containing polygon centroids (POINT). 
Values for cells containing more than one centroid will be averaged (MERGE) 
and those with no centroids will be allocated the DEFAULT value. 


8.4.0.0 *~*DELETE COMMAND 


This command is used to delete variables from non-locational DATA files or GRID files. 
Empty slot resulting may then be used to store new variables 


Within *DELETE the following parameters are available: 


VARIABLE (VARNO) /\/ specifies variable number to be deleted 
VARNAME (NAME) ‘LI specifies variable name to be deleted 
DATAFILE (DATA) /K, = ON/ specifies non-locational DATA file 
GRIDFILE (GRID) /K/ specifies GRID file 

FROM /K/ used for linkage 
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For example: 
*DELETE VARNAME = SURFAREA FROM DATAFILE 


DELETEsa variable called SURFAREA FROM a non-locational DATAFILE. 


8.5.0.0 *~LOCATE COMMAND 
This command ts used to describe geographic searching procedures. 


The results of a geographic search are stored as a variable in a GIMMS non-locational 
DATA file. 


Within *LOCATE the following parameters are available: 


FILEIN (IN) (FILE) /\/ identifies input channel 

CENTROID /K/ selects centroids of zones for maximum 
efficiency 

VARIABLE (VAR) /\! outputs variable number 

/L/ outputs variable name 

VALUE (V) (SET) /R, = 1.0/ specifies value to be stored when search !s 
successful 

MERGE (ADD) /K/ adds VALUE to an existing variable 

SEQUENCE /K/ specifies sequence number for search 

TO /K/ used for linkage 

WITH /K/ used for linkage 

FROM /K/ used for linkage 

IF /K/ used for linkage 

IS /K/ used for linkage 

FUNCTION /K/ specifies function 

DISTANCE (D) /K/ applies distance search 

OVERLAP (QO) /K/ applies overlap (intersection) search 

INSIDE (1) /K/ applies enclosure search 

ANGLE (A) /K/ applies angular cone search 

VALUE1 /R/ specifies first value for search using 
distance/angle 

VALUE2 /R/ specifies second value for search using 
distance/angle 

POINT /K/ specifies point entity 

LINE /K/ specifies line entity 

POLYGON /K/ specifies polygon entity 

DESC /RV,:P/ describes point, line or polygon 


Further Notes on *LOCATE Parameters 

FILEIN 
This parameter identifies the channel to which the locational data file has been 
assigned by the user using the command *FILEPARM (see Section 3.3.1.2). For 
example: 


*LOCATE FILEIN = 11.... 


would read a locational data file from channel 11. 
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The locational data file may describe points, lines, polygons or segments but 
MUST match the non-locational DATA file to be used in the geographic search in 
terms of the order and number of zones. 


VARIABLE, VALUE, MERGE 


When a geographic search Is initialised, each case is tested against the *~LOCATE 
condition and results are stored in an attribute variable in the non-locational 
DATA file. This attribute variable is generally a new variable and may be 
allocated aname using the parameter VARIABLE. For example: 


*LOCATE FILEIN= 11 VARIABLE = NEWVAR.... 
would store the results of the geographic search in the variable NEWVAR. 
Initially, values for the attribute variable are set to zero. When the conditions of 
a search are fulfilled, the attribute variable may be allocated a VALUE. For 
example: 


*LOCATE FILEIN= 11 VARIABLE = NEWVAR VALUE = 5..... 


would allocate the value 5 to the variable NEWVAR when the geographic search 
was successful. The default setting Is 1. 


N.B.  |f the conditions of a geographic search are unsuccessful, the attribute 
variable will be allocated the value 0. 


If the parameter MERGE Is specified, the VALUE is added to the value already 
existing in the attribute variable. MERGE only applies if an existing variable ts 
used as the attribute variable and can be used to accumulate values over several 
*LOCATE commands. For example: 


*LOCATE ... VARIABLE = NEWVAR ... 


“LOCATE. VARIABLE = NEWVAR.... 


After these two commands have been executed, the variable NEWVAR will 
display one of 3 values for each zone: 


O - if both geographic searches were unsuccessful 
1 - 1f one geographic search was successful 
2 - if both geographic searches were successful 


This range of values can be expanded using the parameter VALUE. For example: 


*LOCATE ... VARIABLE = NEWVAR VALUE = 1... 


*LOCATE .. VARIABLE = NEWVAR VALUE = 2... MERGE 


After these two commands have been executed, the variable NEWVAR will 
display one of 4 values for each zone: 


- if both geographic searches were unsuccessful 
- if only the first search was successful 

- if only the second search was successful 

- if both searches were successful 
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DISTANCE, OVERLAP, INSIDE, ANGLE, SEQUENCE 
These parameters are used to describe the terms of a geographic search. 
DISTANCE 


If the parameter DISTANCE is specified, zones (or entities) such as point, lines or 
polygons may be located within a specified distance from a POINT, LINE or 
POLYGON. Forexample: 


*LOCATE FILEIN= 10 VARIABLE = ATTVAR 
DISTANCE = 3000 FROM POINT 295000, 310500 


This command results in the variable ATTVAR displaying a value of 0 or 1 for each 
zone in the DATA file, depending on its distance from the POINT (295000, 
310500). A value of 1 will be allocated when the zone ts less than or equal to the 
specified DISTANCE of 3000 map units, while a value of 0 will be allocated when 
it is greater than 3000 map units. This type of radial distance search is illustrated 
In Figure 8.1. 


If a point file is being used, any point falling within the given search radius will 
be tagged as located’. If a line file is being used, a particular line will be 
‘located’ if any point on the line lies within the given search radius. The situation 
for polygon files is similar to line files and is illustrated in Figure 8.2. In this 
diagram two polygons have been labelled A and B. Polygon A will be tagged as 
‘located’ as part of its boundary line lies within the search radius. 


In addition to the distance or radial search, a point-in-polygon search is also 
performed when polygon files are being used to ensure that the search area 
does not fall completely within a single polygon (see Figure 8.3). 


If two DISTANCE values are input, the search is for entities within the defined 
band. The first value specifies the outer limit of the band, while the second value 
specifies the inner limit. For example: 


*LOCATE FILEIN= 10 VARIABLE = ATTVAR 
DISTANCE = 3000, 1500 FROM POINT 295000, 310500 


This command defines a band around the POINT (295000, 310500) similar to the 
shaded area in Figure 8.4. 


Geographic searching using DISTANCE may be applied to all types locational 
data files, i.e. point, line or polygon. 


N.B. DISTANCE values MUST be specified in map units. 
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Figure 8.1 A Search Radius 
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Figure 8.2 Point/Polygon Distance Searching 
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Figure 8.3 Polygon Searching 
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OVERLAP 


If the parameter OVERLAP Is specified, entities such as points, lines or polygons 
may be located when intersected by a specified LINE or POLYGON. For example: 


*LOCATE FILEIN= 10 VARIABLE = ATTVAR 
OVERLAP LINE 345,123, 676,297, 912,183 


This command would locate any entity intersected by, or containing, the LINE 
described by the three coordinate values (345,123) (676,297) and (912,183). 
These coordinates are expressed tn map units. 


If a LINE is described, it may only be checked against line or pol on files. Ifa 
POLYGON is described, it may be checked against point, line or polygon files. 
Point-in-polygon searching ts again applied as appropriate. 


INSIDE 


If the parameter INSIDE ts specified, points, lines or polygons lying within other 
polygons may be located. For example: 


*LOCATE FILEIN = 10 VARIABLE = ATTVAR 
INSIDE POLYGON = 295000, 310500 
295000, 390000 
350000, 390000 
350000, 310500 
295000, 310500 


This command would locate those zones lying completely within the POLYGON 
defined by the list of coordinates. These coordinates are expressed in map units. 


N.B. Parameters INSIDE and OVERLAP are bi-directional. This means that 
zones may be located which lie inside or intersect with a zone on the file, 
or an zone on the file may be inside or intersect with the defined zone. 
For example: 


*LOCATE FILEIN = 10 VARIABLE = ATTVAR 
INSIDE POLYGON 295000, 310500 
295000, 390000 
350000, 390000 
350000, 310500 
295000, 310500 


These coordinates defines a square. Any zone that contains, or falls 
within this square will be tagged as located’. 


ANGLE 


if the parameter ANGLE Is specified, entities falling within a specified angle-cone 
froma POINT, LINE or POLYGON may be located. 


The ANGLE ts defined as follows: 


i) The base line for measurement is a line due east from the specified 
POINT, LINE or POLYGON. This corresponds to 0 degrees. 


ii) The angle cone is specified by up to two angle lines, measured from the 
base line in degrees anti-clockwise. 


iii) The first angle specified should be the higher value. 


For example: 


*LOCATE FILEIN= 11 VARIABLE = NEWVAR 
ANGLE 45 FROM POINT 546, 798 


This command locates entities falling within a 45 degree ANGLE cone from the 
POINT (546, 798) (see Figure 8.5(a)). In addition, Figure 8.5(b) illustrates ANGLE 
values required to defined the small arc (i.e. ANGLE = 45, -45) or the large arc 
(i.e. ANGLE = 315, 45). 


Where the geographic search is not performed using a POINT, the angle cone 
will expand to include the complete LINE or POLYGON. For example, Figure 8.6 
illustrates the ANGLE cone defined by the command: 


*LOCATEFILEIN = 10 VARIABLE = ATTVAR 
ANGLE = 45 FROM LINE 546, 798 
500, 850 
590, 895 
540, 964 


Multiple Searches 


More than one POINT, LINE or POLYGON may be defined and used in a 
geographic search providing each is separated from the next by the slash (/) and 
the command is terminated by an asterisk (*). For example: 


*LOCATE 
FILEIN= 11 VARIABLE = LOCRES 
DISTANCE 150 FROM 
POINT 295000, 310500 / 
290700, 324300 / 
283500, 307200 * 


This command results in the Attribute Variable LOCRES being 1 when an entity 
from the locational data file ts located within 150 map units from any of the 
three POINTs specified. 


In addition, if the parameter SEQUENCE was specified, the value for LOCRES 
would be set to the POINT sequence number. If an entity from the locational 
data file was ‘located’ by the first search, the value 1 would be stored in LOCRES; 
if a zone was ‘located’ by the second search, the value 2 would be stored; if an 
entity was ‘located’ by the third search, the value 3 would be recorded. 


CENTROID 


Geographic searching may consume significant processing time. For example, if 
a DISTANCE search is performed on a polygon file using a POLYGON description, 
all points in the POLYGON will be tested against all points in the polygon file. 


Figure 8.5 Specifying Angles 
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To increase the efficiency and speed of such a search the parameter CENTROID 
may be specified. This parameter will only test against the centroids stored in 
the polygon file. Although the search may not be as accurate it will be 
considerably faster. 


POINT,LINE, POLYGON 


The description used in the geographic search may define POINTs, LINEs or 
POLYGONs. A POINT is defined by a single coordinate, a LINE is defined by two 
or more coordinates, and a POLYGON is defined by three or more coordinates 
which MUST close. In addition, a POLYGON may contain islands or holes. 


Example of *~LOCATE 


*FILEPARM 11 POLYGONS’ GIMMS 
*FILEPARM DATA ‘DATAFILE’ GIMMS 
*MANIPULATE 
*LOCATE FILEIN= 11 VARIABLE = RES VALUE = 2 
IF DISTANCE 5400 FROM POINT 295000, 310500 
*END 
*STOP 


A new variable called RES will be created in the non-locational DATA file. This 
variable will contain the VALUE 2 for all polygons in the GIMMS locational data 
file which are located within a distance of 5400 map units from the POINT 
(295000, 310500). All other zones will have a value of zero. 


N.B. There must be sufficient space in the non-locational DATA file to store 
the new variable RES. 


8.6.0.0 *SUBSET COMMAND 


This command ts used to subset a non-locational DATA file or GRID file on the basis of 
a data variable or attribute and create a new locational data file. 


In effect, *SUBSET is used to collapse a non-locational DATA file. For example: 
*SUBSET DATAFILE VARIABLE = POP LESS THAN 10000 
would select only those zones where the variable POP ts LESS than 10000. 


*SUBSET may also be used to collapse the GIMMS locational file associated with a 
DATA file. For example: 


*FILEPARM 11 ‘POLYGONS’ GIMMS 
*FILEPARM 12 ‘SUBSETPOLY’ GIMMS 
*FILEPARM DATA ‘DATAFILE' GIMMS 


*MANIPULATE 
*SUBSET FILEIN = 11 FILEOUT = 12 
DATAFILE VARIABLE =POP LESS THAN 10000 


*END 
*STOP 


The above GIMMS command run would subset the locational data file input on 
channel 11 on the basis of the values stored in the non-locational DATA file for the 
variable POP. The subsetted locational data file will be output to channel 12 and may 
then be used in asubsequent GIMMS command run to generate a map. 


Within *SUBSET the following parameters are available: 


FILEIN (IN) /\/ identifies input channel 
FILEOUT (OUT) /\, = 20/ identifies output channel 
DATAFILE (DATA) /K, =ON/ selects non-locational DATA file 
GRIDFILE (GRID) /K/ selects GRID file 
RECOPY (COPY) /K/ copies subset zone file to original file 
VARIABLE (VAR) /\/ specifies variable number 

/L/ specifies variable name 
EQUAL /K/ specifies variable EQUAL to VALUE 
NOTEQUAL /K/ specifies variable NOT EQUAL to VALUE 
LESS /K/ specifies variable LESS than VALUE 
MORE /K/ specifies variable MORE than VALUE 
THAN /K/ used for linkage 
TO /K/ used for linkage 
VALUE /R/ specifies value on which condition will 

operate 

VALNAME /L/ specifies label value 


Further Notes on *SUBSET Parameters 
DATAFILE, GRIDFILE 
These parameters define the type of file to be used by *SUBSET. 


If DATAFILE is specified, a non-locational DATA file is selected; if GRIDFILE ts 
specified a GRID file is selected. The default setting is DATAFILE. 


FILEIN,FILEOUT 


In general, a locational data file will be subsetted at the same time as a non- 
locational DATA file or GRID file so that the new data set can be readily mapped. 


The parameter FILEIN specifies the channel number from which the locational 
file will be read. The parameter FILEOUT directs the subsetted locational data 
file to an output channel. In both cases, channels should have been previously 
assigned by the user using the command *FILEPARM (see Section 3.3.1.2). 


If FILEOUT is not specified, output is written to a temporary workfile on channel 
20 and is ‘lost’ at the end of the GIMMS command run. 


RECOPY 


This parameter may be used as an alternative to FILEOUT and will overwrite the 
original locational data file with the subsetted data file. 


N.B. RECOPY should be used with care as the original locational data file will 
be destroyed. 


VARIABLE 


This parameter specifies the name of the variable on the DATA file or GRID file to 
be used as the basis of the subset. 


The variable may be identified by its position in the DATA/ GRID file, (e.g. 
VARIABLE = 5 to select the fifth variable) or by name (e.g. VARIABLE = POP). 
EQUAL, NOTEQUAL, LESS, MORE, THAN, TO 


These parameters specify the conditions of a subset. They are expressed as 
follows: 


EQUAL TO e.g. VARIABLE =POP EQUAL TO 1000 
NOTEQUAL TO eg. VARIABLE =POP NOTEQUAL 701000 
LESS THAN e.g. VARIABLE =POP LESS THAN 1000 
MORE THAN e.g. VARIABLE =POP MORE THAN 1000 


The words TO and THAN may be omitted as they are only used to link condition 
statements and take no part in the subsetting operation. 


Although combinations of these conditions are not allowed, a sequence of 
*SUBSET commands may be issued. For example: 


*SUBSET DATAFILE VARIABLE = POP MORE THAN ~— 10000 
*SUBSET DATAFILE VARIABLE = POP LESS THAN 100000 


The results of these two *SUBSET commands would select those zones where 
POP was greater than 10000 but less than 100000. 
VALUE, VALNAME 


These parameters are used to specify the value to be used in the subset. For 
example: 


“SUBSET DATAFILE VARIABLE = POP LESS THAN VALUE = 1000 


If the value is an alphanumeric label the parameter VALNAME its used. For 
example: 


*SUBSET DATAFILE VARIABLE = SEX EQUAL TO VALNAME = MALE 


THAN, TO 


These parameter names may be omitted from a *SUBSET command. For 
example: 


*SUBSET DATAFILE VARIABLE = POP LESS 1000 


*SUBSET DATAFILE VARIABLE = SEX EQUAL MALE 
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Examples of *SUBSET 


EXAMPLE 1 


*FILEPARM DATA 'DATAFILE’ GIMMS 
“MANIPULATE 


*SUBSET DATAFILE VARIABLE = ZONENAME LESS THAN Z05 


*END 
*STOP 


This GIMMS command run subsets the non-locational DATA file using the value 
for the alphanumeric variable ZONENAME. 


EXAMPLE 2 


*FILEPARM 11 ‘POLYGONS’ GIMMS 

*FILEPARM 12 ‘SUBSETPOLY’ GIMMS 

*FILEPARM DATA 'DATAFILE’ GIMMS 
*MANIPULATE 


*SUBSET DATAFILE FILEIN= 11 FILEOUT = 12 
VARIABLE = AREA LESS THAN 3500 


*END 
*STOP 


This GIMMS command run reads a locational data file from channel 11 and 
create a subsetted locational data file on channel 12. The polygons stored in the 
subset are those with an area of less than 3500 map units. The non-locational 
DATA file ts also subsetted. 


EXAMPLE 3 


*FILEPARM 11 ‘POLYGONS’ GIMMS 
*FILEPARM 12 'SUBSETPOLY’ GIMMS 
*MANIPULATE 


*SUBSET DATAFILE FILEIN= 11 FILEOUT = 12 
VARIABLE INDEX LESS THAN 351 


*SUBSET DATAFILE FILEIN= 12 RECOPY 
VARIABLE INDEX MORE THAN 149 


*END 
*STOP 


*SUBSET may be used several times within the same GIMMS command run to 
define more complex conditions. The above example selects only those zones 


where the value for the variable INDEX falls between 150 and 350 inclusive. The 
results are output to channel 12. 


8.7.0.0 *INTERP AND *SMOOTH COMMANDS 


These commands relate specifically to GRID files and are used to interpolate and 
smooth the grid surface. 


*INTERP and *SMOOTH share many of the same parameters. 


*SMOOTH Command 


The general format of this command defines an input variable, an output variable and 
a smoothing RANGE. For example: 


*SMOOTH IN= VALUE1 OUT = VALUE2 RANGE = 2 


would result in the smoothing of the grid surface contained in variable VALUE1, using 
a RANGE setting of 2 (see below). Output will be stored in variable VALUE2. 


*INTERP Command 


The format of this command is similar to *SMOOTH, except that more parameters will 
generally be specified. In addition, the input variable will often have a different 
structure, largely because values will be sparsely distributed over the grid surface. 
*INTERP therefore operates when only a limited number of values are available. For 
example: 


*INTERP IN = VALUE1 OUT = VALUE2 
RANGE = 10 MINPTS= 4 MAXPTS= 10 
METHOD = WTAVG 


would interpolate from variable VALUE1 and output results to variable VALUE2. A 
selection of between 4 (MINPTS) and 10 (MAXPTS) points (cells) will be used in the 
interpolation of a particular cell. In addition, a search will be made of up to 10 
(RANGE) cells from the cell being interpolated. 


Inhibiting Cells 


In many situations, the grid will extend beyond the study area. An INHIBIT variable 
may then be specified by the user to halt processing of those cells containing the 
inhibit value. 


Ignoring Cells with Specific Values 


In some cases, values for particular cells should not be used for the purposes of 
interpolation or smoothing. For example, a cell may have a value indicating that it is 
undefined. The parameter IGNORE may be used to define such a value and cells with 
this value will be excluded from smoothing and interpolation routines. 


Within the commands *SMOOTH and *!INTERP the following parameters are available: 


INVAR (IN) /\/ specifies variable for interpolation § or 
| smoothing 

INNAME /U/ specifies name of variable for interpolation 
orsmoothing 

OUTVAR (OUT) [l/ specifies variable for output 

OUTNAME /L/ specifies variable name for output 

INHIBIT /\/ specifies variable for inhibit cells 

INHIBNAME /L/ specifies variable name for inhibit cell 

INHIBVAL /R/ specifies value for inhibition 

INHIBOUT /R/ specifies output value for inhibition 

RANGE /\/ specifies range for smoothing or limit for 
interpolation 

MINPTS (MIN) /\,=4/ specifies minimum number of points to be 
used for interpolation 

MAXPTS (MAX) /\/ specifies maximum number of points to be 
used for interpolation 

IGNORE /R, = -999999/ specifies value for which cell should be 
ignored 

SMOOTH /K/ selects smoothing 

INTERP /K/ selects interpolation 

METHOD /\/ selects method 

AVERAGE /K/ produces average for all valid cells 

WTAVG /K/ produces weighted average for all valid 
cells 

USER /K/ selects user defined METHOD 

USERVALS /R,REPEAT = 8/ specifies user defined values 


Further notes on *SMOOTH and *INTERP Parameters 
INVAR, INNAME, OUTVAR, OUTNAME 


The parameters INVAR and INNAME are used to identify an input variable, while 
the parameters OUTVAR and OUTNAME are used to assign an output variable. 
Forexample: 


*SMOOTH INVAR = VALUE1 
OUTVAR = VALUEZ2..... 


would specify VALUE1 as the input variable and VALUE2 as the output vartable. 


N.B. The parameter names INNAME and OUTNAME are generally omitted and 
interpretation of the command relies on GPIS (see Section 2.2.2.0). 


INHIBIT, INHIBNAME, INHIBVAL, INHIBOUT 


These parameters describe the inhibit variable and provide a means to restrict 
processing within the boundaries of a defined study area. For example: 


*SMOOTH INVAR = VALUE1 
OUTVAR = VALUE2 
INHIBIT = OUTAREA 
INHIBVAL = -999999 INHIBOUT = -99 
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identifies the inhibit variable as OUTAREA and cells with a value -999999 
(defined by INHIBVAL) will not be smoothed. The output value stored in the 
GRID file in variable VALUE2 for these cells will be allocated the value -99 
(defined by INHIBOUT). 


RANGE, MINPTS, MAXPTS 


These parameters control the degree of smoothing or the extent of 
interpolation. 


When used with *SMOOTH, RANGE defines the radius of cells to be considered in 
the smoothing process. A value of 1 means that the cell and its immediate 8 
surrounding cells will be considered; a value of 2 means the cell and its 24 
surrounding cells will be considered. 

When used with *INTERP, RANGE defines the maximum distance over which 


surrounding cells will be considered. Within this RANGE, an attempt will be 
made to use between the specified number of MINPTS and MAXPTS cells. 


IGNORE 


This parameter defines which cells are valid for inter-polation or smoothing. For 
example: 


.. IGNORE = -999... 
means that any cell with a value of -999 will be excluded from smoothing and 
interpolation routines. 
METHOD, AVERAGE, WTAVG, USER 
These parameters control the method of interpolation. For example: 
*INTERP ..... METHOD = WTAVG ...... 
would select the WTAVG method for interpolation 


Currently only three methods of interpolation are available: 


AVERAGE produces an average for all valid cells 

WTAVG calculates a distance weighted average for all valid 
cells 

USER accesses a user defined method stored in a subroutine. 


Users should contact GIMMS Ltd. for a description of 
the interface. 


Examples of *SMOOTH and *INTERP 


EXAMPLE 1 


*FILEPARM GRID 'GRIDFILE’ GIMMS 
*MANIPULATE 


*SMOOTH INVAR = HEIGHT OUTVAR = NEWHEIGHT RANGE = 3 


*END 
*STOP 


This GIMMS command run uses the variable HEIGHT to create a new smoothed 
variable NEWHEIGHT. 


EXAMPLE 2 


*FILEPARM GRID 'GRIDFILE’ GIMMS 
*MANIPULATE 


*INTERP INVAR = RAINFALL OUTVAR = RAINFALL2 
IGNORE = 0 METHOD = WTAVG RANGE = 30 
MINPTS = 3 MAXPTS= 5 


*END 
*STOP 


This GIMMS command run interpolates a new variable RAINFALL2 from an 
existing variable RAINFALL. Interpolation is performed using the weighted 


average method (WTAVG) over 3 to 5 cells. Cells with a value of 0 will be 
ignored. 
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SECTION 9 : *UTILITIES APPLICATION MODULE 


CONTENTS 


THE *UTILITIES APPLICATION MODULE 
9.0.1.0 Commands Available 
* ALPHABET COMMAND 
*CREATE COMMAND 

*END COMMAND 

*FILEDUMP COMMAND 
*MERGE COMMAND 
*MODCENT COMMAND 
*SAVE/ *RESTORE COMMANDS 
*TERMINAL COMMANDS 
*MACRO COMMANDS 

*CALL COMMANDS 


9.0.0.0 THE *UTILITIES APPLICATION MODULE 


The *UTILITIES Application Module incorporates a range of facilities to create and 
maintain files and generate ‘filedump files for input to other packages. 


The *UTILITIES module may be accessed directly from the Main Control Program: 
<Commands available from the Main Control Program > 
*UTILITIES <to access the *UTILITIES module> 
<Commands available within *UTILITIES > 


*END <to return to Main Control Program > 
*STOP 


The *UTILITIES module may also be accessed indirectly from the *MANIPULATE or 
*PLOTPROG modules: 
a) Access from *MANIPULATE 

<Commands available from the Main Control Program > 


*MANIPULATE <to access the *MANIPULATE module > 
<Commands available within *MANIPULATE > 


*UTILITIES <to access *UTILITIES module > 
<Commands available within *UTILITIES > 
*END <to return to *MANIPULATE module> 
<Commands available within *~MANIPULATE > 
*END <to return to the Main Control Program > 
*STOP <to terminate the GIMMS command run> 


b) Access from *PLOTPROG 
<Commands available from the Main Control Program > 


*PLOTPROG <to access the *PLOTPROG module 
<Commands available within *PLOTPROG > 
*UTILITIES <to access *UTILITIES module > 
<Commands available within * UTILITIES > 


*END <to return to *PLOTPROG module > 
<Commands available within *PLOTPROG > 
*END <to return to the Main Control Program > 
*STOP <to terminate the GIMMS command run> 


9.0.1.0 Commands Available 


The following commands are available within the * UTILITIES module: 


* ALPHABET creates new alphabets 
*CALL accesses GIMMS macros 
*CHECK/* CHECK2 checks segment files 
*CREATE creates DATA and GRID files 
*END exits from *UTILITIES module 
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*FILEDUMP generates filedump files 


*FILEIN inputs data 

*FILEINFO prints descriptive information about GIMMS data files 
*MERGE merges 2 or more GIMMS locational data files 
*MODCENT modifies position of polygon centroids 
*POLYGON/*POLY2 creates polygon files from segment files 

*RESTORE restores non-locational DATA or GRID files 

*SAVE saves non-locational DATA or GRID files 

*TERMINAL configures terminal 

*USER calls user supplied subroutine 


The command *FILEINFO ts discussed in Section 3; *FILEIN is discussed in Section 4; and 
*CHECK/* CHECK2 and *POLYGON/*POLY2 are discussed in Section 5. The remaining 
commands are described below. 


9.1.0.0 *ALPHABET COMMAND 
This command may be used to input new alphabets. 


* ALPHABET will read alphabet descriptions from a specified file and add these to 
the existing GIMMS Alphabet File. Alphabet descriptions must be provided in the 
form described in Appendix D. 


When a new alphabet has been created,it can be accessed in the normal way using the 
parameter ALPHABET within the *TEXTPARM or *TEXT commands or using the @nn 
convention described in Appendix A. 


Within *ALPHABET the following parameters are available: 


RESET (PASSWORD) /L/ clears GIMMS Alphabet File when 
correct password issued 

READ (INPUT) (INFILE) (IN) /\, = SPECIAL/ reads file containing new alphabet(s) 
descriptions 

DRAW /,.REPEAT =20/ plots alphabet(s) 


N.B. If a new alphabet Is specified as temporary (see Appendix D under ‘Alphabet 
Finish Line’), it will only exist for the duration of the current GIMMS command 
run; alphabets specified as permanent will be available on subsequent 
command runs 


Further Notes on *ALPHABET Parameters 
RESET 
This parameter may be specified to clear the existing GIMMS Alphabet File 


before new alphabet descriptions are read. The password required is known 
only to the installation to ensure that alphabets are not inadvertently destroyed. 


READ 


This parameter specifies the channel number from which new alphabet 
descriptions will be read. For example: 


*ALPHABET RESET =password READ = 14 


will read new alphabet descriptions from channel 14. This channel will have 
been previously assigned by the user using the command *FILEPARM (see Section 
3.3.1.2). 


New alphabet descriptions may be included within a GIMMS command run. In 
this case, the parameter READ is not required. However, the *ALPHABET 
command must be terminated by an asterisk (*) or a slash (/) and alphabet 
descriptions begin on the next line. For example: 


“UTILITIES 
*ALPHABET * 


A... <Alphabet Start Line > 
C... <Character Start Line> 


E <Alphabet End Line> 
F <Alphabet Finish Line> 
*END 
*STOP 


The specification of new alphabets is described in Appendix D. 


DRAW 
This parameter may be used to plot selected alphabet tables. For example: 
*ALPHABET DRAW 2,11 
would plot alphabets 2 and 11 (see Appendix B). 


If specific alphabets are not referenced by the parameter DRAW, the complete 
GIMMS alphabet tables, contained in the Alphabet File, will be plotted. 


Examples of *ALPHABET 
EXAMPLE 1 
*EILEPARM 14 'NEWALPHABET' TEXT 


*UTILITIES 
*ALPHABET RESET = password READ = 14 


This GIMMS command run clears the existing GIMMS Alphabet File using the 
parameter RESET, and reads new alphabet descriptions from channel 14. 


EXAMPLE 2 


*FILEPARM 19 ‘PLOTFILE’ TEXT 
*PLOTPARM PLOTTER 
*UTILITIES 
*ALPHABET DRAW 
*END 
*STOP 


This GIMMS command creates a plot file on channel 19 suitable for output to a 
graph plotter (*PLOTPARM PLOTTER). The complete GIMMS Alphabet Tables, 
contained in the Alphabet File, will be plotted. 

9.2.0.0 *CREATE COMMAND 


This command may be used to create non-locational DATA files or GRID files. 


Data values may be merged with DATA or GRID files using the command *FILEIN (see 
Section 4.3.2.0 under MERGE). 


Within *CREATE the following parameters are available: 


DATA (DATAFILE) /K/ selects non-locational DATA file 

GRID (GRIDFILE) /K/ selects GRID file 

FILEIN (IN) /\/ specifies input channel for 
Polygon file 

FILENAME (NAME) /L/ specifies internal mame _ for 
output file 

XCELL (CELLSIZE) /\/ specifies X-dimension of cell for 
GRID file 

YGELL /l,=K:XCELL/ specifies Y-dimension of cell for 
GRID file 

XORIGIN (ORIGIN) /\/ specifies X-origin of grid 

YORIGIN A/ specifies Y-origin of grid 

ROWS /\/ specifies number of rows in grid 

COLUMNS (COLS) /\/ specifies number of columns in 
grid 

VARS (VAR) (V) (MACROS) /\, = 100/ specifies maximum number of 
variables 

NZONES (ZONES) /V, = (C: FILEIN)/ specifies number of zones 

TITLE /S, ='NONE'/ specifies internal title for output 
file 


Parameters used to Create a Non-locational DATA File 
*FILEPARM 11 ‘'UKPOLY’' GIMMS 
*FILEPARM DATA 'UKDATA' GIMMS OUT 
* UTILITIES 
*CREATE 


DATAFILE FILEIN = 11 VARS = 9 
FILENAME = UKREG 
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TITLE = ‘DATAfile for UK Regions’ 
<Variables may be added using *FILEIN> 
*END 


*STOP 


These commands are described below. 


*FILEPARM 11 'UKPOLY' GIMMS 
This command attaches a polygon file called 'UKPOLY' to channel 11. 


N.B. Thecommand *FILEPARM is fully described in Section 3.3.1.2. 


*FILEPARM DATA ‘UKDATA’ GIMMS OUT 
This command attaches a file called 'UKDATA’ using the parameter DATA. This ts 
a GIMMS file and will be created (OUT) as a result of the current GIMMS 
command run. 


N.B. Thecommand *FILEPARM is fully described in Section 3.3.1.2. 


“UTILITIES 


This command accesses the * UTILITIES Application Module. 


*CREATE 
This command indicates that a new data file will be created as a result of the 
current GIMMS command run. 

DATAFILE 


This parameter specifies that a non-locational DATA file will be created. 


FILEIN = 11 


This parameter is used to link the non-locational DATA file to an existing 
polygon file, assigned by the user in this example to channel 11. 


N.B. When a DATA file is linked to a polygon file, the number of zones is 
automatically calculated; if the DATA file were not linked to a polygon 
file the number of zones would have to be specified using the parameter 
NZONES (or ZONES). 


VARS =9 


This parameter is used to allocate space to store new variables. In the above 
example, sufficient space will be available to store up to 9 variables. However, 5 
variable slots will be filled automatically with information relating to the 
locational file referenced by FILEIN. The names and descriptions of these 
variables is as follows: 


Variable Name Description 
ZONENAME name of polygon 
NAME2 second part of name 
SURFAREA surface area 
XCENT X-centroid coordinate value 
YCENT Y-centroid coordinate value 


As a result there will only be enough space to store a further 4 variables in this 
example. These may be supplied using the command *FILEIN (see Section 4.3.2.0 
under MERGE). 


FILENAME = UKREG 


This parameter allocates an internal filename to the output DATA file. This 
name may be up to 10 characters long, the first of which MUST be a letter. 


TITLE = ‘DATA file for UK Regions: 


This parameter may be used to document the data being recorded. It provides a 
convenient way for users to comment on the contents of a file and can serve as a 
useful reminder at a later date. 


TITLE information MUST be enclosed by primes ("') and will be printed, together 
with the FILENAME, !f the DATA file is interrogated using the command 
*FILEINFO (see Section 3.3.3.4). 


< Variables may be added using *FILEIN> 


At this stage data values for some or all of the remaining 4 empty variable slots 
may be included. For example, the following command may be used to add a 
further 2 variables to the DATA file: 


*FILEIN DATAFILE MERGE VARS = 2 ZONES = 10 
NAMES = POP WHEAT 


BEGIN 


12394 26 
9867 18 
2341 30 

10675 29 

94378 34 

67534 20 
7865 50 
8675 10 
6754 42 

11367 25 


The commands used above are described in Section 4. 


N.B. The parameter MERGE is required to add variables to a DATA file when it 
has been *CREATEd. 


*END 


This command exits from *UTILITIES and returns control to the Main Control 
Program. 


*STOP 


This command terminates the GIMMS command run. 


Parameters used to Create a GRID file 


*FILEPARM GRID ‘'UKGRID' GIMMS OUT 
*UTILITIES 
*CREATE 
GRIDFILE VARS = 10 
FILENAME = UKGRID1 
TITLE = ‘GRID file for UK’ 
CELLSIZE = 10 
ORIGIN = 0,0 
ROWS = 100 COLUMNS = 70 


< Variables may be added using *FILEIN (see above)> 
*END 


*STOP 


These commands are described below. 

*FILEPARM GRID ‘UKGRID’ GIMMS OUT 
This command attaches a file called ‘UKGRID' using the parameter GRID. This isa 
GIMM'SS file and will be created (OUT) as a result of the current GIMMS command 


run. 


N.B. Thecommand *FILEPARM is fully described in Section 3.3.1.2. 


*UTILITIES 
This command accesses the *UTILITIES Application Module. 
*CREATE 


This command indicates that a new data file will be created as a result of the 
current GIMMS command run. 


GRIDFILE 


This parameter specifies that a GRID file will be created. 


VARS = 10 


This parameter is used to allocate space to the new data file to store variables. In 
this example, enough space will be available to store 10 variables. 


Although 10 variables slots have been allocated, 5 of these will be filled 
automatically by the variables ZONENAME, NAME2, SURFAREA, XCENT and 
YCENT (see above). Asa result there will only be enough space to store a further 
5 variables. These may be supplied using the command *FILEIN (see Section 
4.3.2.0 under MERGE). 


FILENAME = UKGRID1 


This parameter allocates an internal filename to the output GRID file. This name 
may be up to 10 characters long, the first of which MUST be a letter. 


TITLE = ‘GRID file for UK Regions: 


This parameter may be used to document the data being recorded. It provides a 
convenient way for users to comment on the contents of a file and can serve as a 
useful reminder at a later date. 


TITLE information MUST be enclosed by primes ('') and will be printed, together 
with the FILENAME, if the GRID file is interrogated using the command 
*FILEINFO (see Section 3.3.3.4). 


CELLSIZE = 10 


This parameter specifies the resolution of the current GRID file. In this example it 
isset to 10 units. 


lf the GRID file is related to an existing Point, Line or Polygon file, the CELLSIZE 
(and ORIGIN) should be defined in the same map units (i.e. coordinates) used in 
the locational data file. 


ORIGIN = 0,0 


This parameter specifies the origin of the grid. In this example the ORIGIN 
corresponds to the the point (0,0). 


ORIGIN refers to the bottom left corner of the bottom left cell in the grid matrix 
and, if it is to be related to an existing Point, Line or Polygon file, should be 
specified in the same map units (i.e. coordinates) used in the locational data file. 


ROWS = 100, COLUMNS = 70 
These parameters specify the extent of the grid. In this example the grid will 
measure 100 ROWS (i.e. Y-dimension) by 70 COLUMNS (i.e. X-dimension) The 
grid reference of the bottom left corner of the bottom left cell is (0,0) i.e. the 
ORIGIN. References for other cells depend on their position within the grid and 
the cell size. 


N.B. The greater the number of rows and columns the greater the processing 
time required. 


<At this stage variables may be added using *FILEIN (see above) > 


*END 


This command exits from *UTILITIES and returns control to the Main Control 
Program. 


*STOP 


This command terminates the GIMMS command run. 


N.B. The above example *CREATES square cells. If rectangular cells were required, the 
X and Y dimensions may be defined using the parameters XCELL and YCELL. For 
example: 


*CREATE XCELL= 10 YCELL= 5S... 


would create rectangular cells measuring 10 units in X (i.e. width) and 5 units in Y 
(i.e. height). 


9.3.0.0 *END COMMAND 
This command is used to exit from the *UTILITIES module. Control will then return to 


the Main Control Module, *PLOTPROG or *MANIPULATE, depending on from where 
the *UTILITIES module was accessed (see Section 9.0.0.0). 


9.4.0.0 *FILEDUMP COMMAND 
This command may be used to print or 'dump’ the contents of a GIMMS file. The 
resulting output can be used as a diagnostic tool, an archival procedure, or a way of 


transferring data to other packages. 


Within *FILEDUMP the following parameters are available: 


FILEIN (IN) (FILE) 


FILEOUT (OUT) 
MINZONE 
MINNO 


MAXZONE 
MAXNO 


INCLUDE (INCL) 
EXCLUDE (EXCL) 
ZONES (ZONE) 


ZONENAME (NAMES) 


ZONENOS (NOS) (NUMBERS) 


DATAFILE (DATA) 
GRIDFILE (GRID) 


EXPANDED (FULL) 


NOHEADER 
SEQUENCE (SEQ) 
FORMAT (F) 


NODATA 
PACKED 


VARIABLE (VAR) (VARS) 


TO 
RECYCLE 


/\/ 


/\, = SPECIAL/ 
/L/ 
/\/ 


/L/ 
/\/ 


/K/ 
/K/ 
/K/ 
/K,REPEAT = 100/ 


/\,REPEAT = 100/ 


/K/ 
/K/ 
/K/ 
/K/ 


/K/ 


/S/ 
/K/ 
/K/ 


/L,REPEAT = 100/ 
/K/ 
/K/ 


Further Notes on *FILEDUMP Parameters 


FILEIN, DATAFILE, GRIDFILE 


specifies input channel for 
filedump 

specifies output channel 
specifies Mintmum zone name 
specifies minimum zone 
sequence number 

specifies maximum zone name 
specifies maximum zone 
sequence number 

includes zones 

excludes zones 

used for linkage 

lists zone names to be included 
or excluded 

lists Zone sequence numbers to 
be included or excluded 

selects non-locational DATA file 
select GRID file 

selects expanded dump 
suppresses header information 
(i.e. A,B, and Z Lines) 

prints sequence numbers in 
columns 73 to 80 

specifies output format 
suppresses Data Lines 

selects subset of EXPANDED 
filedump 

lists variables to be file dumped 
used for linkage 

outputs data in a form suitable 
for input to *FILEIN 


These parameters are used to identify the data file to be file dumped. FILEIN 
specifies the channel number for a GIMMS locational data file; DATAFILE 
specifies a non-locational DATA file; GRIDFILE specifies a GRID file. For example: 


FILEOUT 


*FILEDUMP FILEIN = 11 


This parameter specifies a channel number for output from *FILEDUMP. For 


example: 


*FILEDUMP FILEIN=11 FILEOUT = 12 


If FILEOUT ts not specified, the results of the *FILEDUMP will be listed on the 


terminal screen. 
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MINZONE, MINNO 


These parameters may be used to specify the name or sequence number of the 
minimum zone to be ‘dumped. For example: 


*FILEDUMP FILEIN= 11 
MINZONE = 2021 


would dump all zones alphabetically greater than or equal to 2021. 
Alternatively, the command: 


*FILEDUMP FILEIN = 11 
MINZONE = 54 


would dump all zones numbered from 54 upwards. 


MAXZONE, MAXNO 


These parameters specify the maximum zone name or sequence number to be 
‘dumped’. They are used in the same way as MINZONE and MINNO (see above). 


INCLUDE, EXCLUDE, ZONES, ZONENAME, ZONENOS 


These parameters may be used to explicitly specify which zones should be 
included or excluded from the filedump and are only valid for Polygon, Line or 
Segment files. For example: 


*FILEDUMP FILEIN = 11 
INCLUDE ZONES 2321,2572,2724,2943 


would only dump zones 2321, 2572, 2724 and 2943. 


Zones may be specified by name or by sequence number and only one INCLUDE 
or EXCLUDE may be issued within a single *FILEDUMP command. 


N.B.  |f aname is specified using MINZONE, MAXZONE, INCLUDE or EXCLUDE, 
it is matched against the FIRST zone label occurring. For example, if the 
file being dumped is asegment file, the command: 


INCLUDE 2543 


would only select those segments referenced with 2543 as the first label; 
segments referenced with 2543 as the second label (e.g. 2540/ 2543) would be 
ignored. 


VARIABLE, VARS, TO 


These parameters may be used to select variables by name from a non-locational 
DATA file or GRID file. For example: 


*FILEDUMP DATAFILE 
VARS =POP,EMP,UNEX TO MEMPINC 
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would select variables POP, EMP and all variables between UNEX and MEMPINC 
inclusive. 


RECYCLE 


This parameter produces suitable character files from existing GIMMS Segment, 
Polygon and Line files for input to *FILEIN (see Section 4). 


In effect, RECYCLE removes the letter A from the A Line, suppresses output from 
the B Line, and adds aslash (/) after each zone description. 


There may be several reasons for recycling locational data files, and especially 
Segment files. When segments are captured they will probably be recorded in 
digitiser coordinates. The *FILEIN module CONVERTs these coordinates to map 
coordinates, while at the same time, AUTONODE is used to match segment end 
points (see Sections 4.3.1.1 under CONVERT and 4.3.1.0 under AUTONODE). 
When a Segment file is correct and polygons close, it is useful to RECYCLE the 
file and produce a clean source. This will process considerably faster than the 
original source file as no CONVERT or AUTONODE matching will be required. 


EXPANDED 
This parameter selects the expanded form of a filedump and each value will be 
printed on a separate line. The format of Data Lines in an EXPANDED filedump 
is described below. 

PACKED 
This parameter produces a subset of the EXPANDED form with most of the 
important information included. The format of Data Lines in a PACKED filedump 
is described below. 

NOHEADER 


This parameter inhibits output of A, B, and Z Lines and only Data Line(s) will be 
printed. A description of A, B, Z and Data Lines is presented below 


SEQUENCE 


This parameter prints sequence numbers in columns 73-80 of the filedump and is 
generally only used with EXPANDED format (see above). 


FORMAT 


This parameter may be used to specify the output format of Data Lines. By 
default the output format will be: 


(10F7.0) 
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and 10 integer values will appear on each Data Line. 


If data values consist of large numbers or include decimal numbers however, the 
default format may be inappropriate. To overwrite this, a standard FORTRAN 
format statement may be included in the *FILEDUMP command. For example: 


*FILEDUMP FILEIN= 11 FILEOUT = 12 
FORMAT = '(14F5.2)' 
would output 14 values per Data Line, each with 2 decimal places. 
N.B. The FORMAT must be enclosed by primes (’’). 


This parameter only makes use of FORTRAN F, A, X, and / format codes. These 
codes will be described in a standard FORTRAN programming manual. 


NODATA 


This parameter may be used to suppress printing of Data Line(s). Only the 
header information contained in the A, B, and Z lines will then be printed. 


Examples of *FILEDUMP 
EXAMPLE 1 


*FILEPARM 11 POLYGONS’ GIMMS 
*FILEPARM 12 'FDUMP' TEXT 
*UTILITIES 

*FILEDUMP FILEIN = 11 FILEOUT = 12 
*END 
*STOP 


The contents of the locational data file assigned to channel 11 will be output to 
the character file assigned to channel 12. 
EXAMPLE 2 
*FILEPARM DATA ‘DATAFILE’ GIMMS 


*UTILITIES 
*FILEDUMP DATAFILE 


The contents of the non-locational DATA file, referenced by the command 
*FILEPARM DATA, will be listed on the terminal screen. 
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EXAMPLE 3 


*FILEPARM 13 ‘FOUMP’ TEXT 
*FILEPARM DATA ‘DATAFILE’ GIMMS 
“UTILITIES 
*FILEDUMP FILEOUT = 13 DATAFILE VARS = POP,EMP 
*END 
*STOP 


Values for the selected variables POP and EMP, will be output to the character 
file assigned to channel 13. 


EXAMPLE 4 


*FILEPARM 11 ‘POLYGONS’ GIMMS 
*FILEPARM 12 'FDUMP' TEXT 
“UTILITIES 
*FILEDUMP FILEIN= 11 FILEOUT = 12 
MINZONE = 215 MAXZONE = 252 SEQUENCE 
*END 
*STOP 


The description of zones 215 to 252 inclusive, together with sequence numbers, 
will be output to the character file assigned to channel 12. 


The Format of a Filedump 


The format of a filedump will vary depending on the type of file and the parameters 
selected. In general however, a filedump consists of information for each segment, 
area, line, point, DATAFILE, or GRIDFILE zone. 


Three separate pieces of information may be included for each zone : 


1) TheA Line 
ii) The BLine 
Wi) Data Line(s) 


The following table illustrates which of these will be produced in relation to the 
different file types: 


File Type A Line B Line Data Lines 
Segment Y Y Y 
Polygon Y Y Y 
Point Y - 
Line Y BG Ra 
DATAFILE/GRIDFILE Y Y 


In addition, a Z Line will be printed at the end of each filedump, unless the parameter 
NOHEADER has been specified. 
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Notes 
(1) If NOHEADER ts specified no A, B, or Z Lines will be printed. 


(2) If NODATA isspecified no Data Lines will be printed. 


The A Line 


The A Line consists of the code letter A followed by the zone sequence number anda 
list of names. 


The format used for the A Line ts: 
( A’ 16,6(1X,2A4),11X,18) 
Information contained in the A Line is as follows: 


Column numbers 


1 A 

2-7 zone sequence number 

8-61 list of (up to 6) zone names 

73-80 line sequence number (if SEQUENCE specified) 


N.B. TheAlinewill NOT be printed if the file type is POINT, DATAFILE or GRIDFILE, 
or if the parameter NOHEADER has been specified. 
The B Line 


The volume of information contained in the B line depends on the type of file being 
dumped. 


The format used for the B Line its: 
('B'16,15,4X,F14.3,1X,F14.3,6X,F14.3,7X,18) 


Information contained in the B Line is as follows: 


FILE TYPE 
Column DATAFILE or 
Numbers Description Segment Polygon Point Line GRIDFILE 
1 B Y Y Y » 4 Y 
2-7 7one sequence number Y Y Y ¥ Y 
8-12 number of coordinates 
(or variables) Y Y Y 
17-30 calculated area of 
zone bg 
32-45 X coordinate of 
centroid (or X value) Y Y Y Y 
52-65 Y coordinate of 
centroid (or Y value) Y Y Y Y 
73-80 line sequence number 
(if SEQUENCE specified) Y Y Y Y Y 
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(1) If a DATAFILE/GRIDFILE is being dumped, columns 8-12 will contain the 
number of variables (values) per zone: 


(2) If a POINT file is being dumped, columns 32-45 and 52-65 will contain the 
X,Y coordinates of the point. 


N.B. TheB Line will NOT be printed if the parameter NOHEADER has been specified. 


The Data Lines 
The Data Lines contain the data values related to each zone. For Segment, Area, and 
Line files, the Data Lines list the stream of (X,Y) coordinates recorded; for non- 
locational DATA and GRID files, they list values for the data variables. Data Lines are 
not accompanied by sequence numbers. 
By default the format used for Data Lines Is as follows: 

(10F7.0) 
This results in 10 integer values being printed per line with values for each zone 
beginning on anewline. The default format may be over-written however, using the 
parameter FORMAT (see above). 
If the B Line has been printed for a Point file, no data values are printed since the 
coordinate has already been printed on the B line. However, if the B Line has not 
been printed for a Point file the X,Y coordinate of the point is printed as the only data 
value. 


N.B. Data Line(s) will not be printed if the parameter NODATA has been specified. 
EXPANDED Data Lines 
If the parameter EXPANDED has been included in the *FILEDUMP command, the data 


values will be printed one per line. This parameter should not be used with POINT files. 


The format used for EXPANDED Data Lines is: 


(''17,1X%,2A4,13,15,16,1X,F14.3,6X,F14.3,7X,18) 


The following table illustrates the information produced for different file types: 
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FILE TYPES 


Column DATAFILE or 
Numbers Description Segment Polygon Line GRIDFILE 
1-7 zone sequence number Y 4 Y Y 
12-13 generalisation code Y - - 
17-19 subzone number (for 

Polygon files) Y - 
20-24 coordinate (or variable) 

sequence number Y Y Y 4 
25-30 boundary link (for Area 

files) Y : 
32-45 X coordinate (or 

DATAFILE/GRIDFILE value) Y Y ba y 
52-65 Y coordinate Y Y Y - 
73-80 line sequence number (if 

SEQUENCE specified) Y Y Y Y 
Notes 

(1) Generalisation codes (columns12-13) may have been defined for Polygon 
files (see Section 5.1.0.0). In the filedump they range in value from 0 to 9.A 
value of zero (0) would indicate that no generalisation codes were 
assigned to the Polygon file: 

(2) Sub-zones (columns 17-19) reflect that a polygon may incorporate ‘islands’ 
or ‘holes’. Each of these is considered as a separate subzone and numbered 
sequentially from 1. For example, a polygon consisting of 3 islands would 
be described as having 3 subzones. 

(3) Coordinate numbers (columns 20-24) indicate the coordinate sequence 
number. If a polygon is being considered, the last coordinate should be 
numbered zero to indicate that it is the same point as the first i.e. the 
polygon is closed. 

(4) Boundary link values (columns 25-30) indicate surrounding zones for 


Polygon files. For each coordinate the boundary link is the sequence 
number of the zone adjacent to the other side of the straight line segment 
joining this point to the point on the next line. As polygons close, the last 
line is a copy of the first line and the boundary link isset to zero. All other 
links of zero indicate that the zone on the other side of the straight line 
segment is outside the study area. Each subzone of an area description is 
considered as a separate zone. 


N.B. Expanded Data Lines will not be produced if a Point file is being dumped or if 
the parameter NODATA has been specified. 


PACKED Data Lines 


lf the parameter PACKED has been included in the *FILEDUMP command, a subset of 
the EXPANDED Data Lines will be produced. This parameter should only be used with 
Polygon files. 
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The format used for PACKED Data Lines is: 
( '11,13,14,217) 


The following table describes the information which will be produced by the 
parameter PACKED: 


Column numbers Description 
1 Generalisation code 
2-4 Sub-zone number 
5-8 Boundary link 
9-15 X-coordinate 
16-22 Y-coordinate 


N.B. The parameter SEQUENCE has no effect if PACKED Data Lines are being 
printed. 
The Z Line 


The Z Line is produced at the end of a file dump and will include the number of zones 
output. 


The format used for the Z Line 1s: 
('2'(,110,110,F14.3,F14.3,F14.3,17,2X,18) 


The following table illustrates which information will be produced for different file 
types. 


FILE TYPE 
Column DATAFILE! 
Numbers _ Description Segment Polygon Point Line GRIDFILE 
1 Z Y Y ns Y Y 
2-11 number of zones 
dumped Y Y Y Y Y 
12-21 number of coordinates Y Y . Y - 
22-35 mean of centroids - 
X value Y Y Y Y 
36-49 mean of centroids - 
Y value Y Y Y Y 
50-63 total area (for area 
files) Y 
64-70 number of subzones Y - a 
73-80 line sequence number 
(if SEQUENCE specified) Y Y 34 Y Y 


N.B. The Z Line will not be produced if the parameter NOHEADER has been 
specified. 
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9.5.0.0 *~MERGE COMMAND 


This command ts used to join together up to twenty GIMMS locational data files. It 
operates on Polygon, Line and Point files. 


Within *MERGE the following parameters are available: 


FILEOUT (OUT) /\/ specifies output channel 

FILENAME (NAME) /L/ specifies internal file name for output 
file 

XMIN (LIMITS) /\/ specifies limits - X minimum value 

Y MIN /\/ specifies limits - Y minimum value 

XMAX /\/ specifies limits - X maximum value 

YMAX /\/ specifies limits - Y maximum value 

TITLE /S/ specifies internal title for output file 

MINCOL Nf specifies minimum column number 

MAXCOL /\/ specifies maximum column number 

REDUCE /R/ sets reduction tolerance for segments 

FILEIN (IN) /|,REPEAT = 20/ specifies input channel(s) 

NAME1 (CHANGE) /L,REPEAT = 100/ specifies first name for zone name 
change 

NAME2 /L,REPEAT = 100/ specifies second name for zone name 
change 

INCLUDE /K, = ON/ includes segments 

EXCLUDE /K/ excludes segments 

LOWNAME /L/ specifies lowest segment name for 
INCLUDE/ EXCLUDE 

HIGHNAME /L/ specifies highest segment name for 


INCLUDE/ EXCLUDE 


Further Notes on *MERGE Parameters 
FILEOUT, FILENAME 


These parameters are used to reference the output file created when two or 
more locational data files are *~*MERGEd. 


FILEOUT directs the output to a channel number and MUST be specified; 
FILENAME may be used to allocate an internal name to the output file. For 
example: 

*MERGE...... FILEOUT = 12 FILENAME = MERGPOLY 


The FILENAME may be up to 10 characters long, the first of which MUST be a 
letter If a FILENAME is not specified in the *~MERGE command, it will be 
automatically set to the name originally allocated to the first input file. 


FILEIN 


This parameter is used to identify channels for input files. A maximum of 20 files 
may be referenced in this way. These files will be added to the merged file in the 
same order as they are specified. For example: 


*MERGE FILEIN= 11, 12, 13 


FILEOUT = 14 FILENAME = MERGPOLY 
TITLE = ‘Merged polygon file’ 
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LIMITS, XMIN, YMIN, XMAX, YMAX 


These parameters are used to set the limits for the merged file and specify a 
rectangular areasimilarto *FILEIN LIMITS (see Section 4.3.1.0). 


If values are not specified in the *~*MERGE command, they will be automatically 
set to the LIMITS originally allocated to the first input file. 


TITLE 


This parameter may be used to specify an internal title for the merged file. This 
title MUST be enclosed by primes ("'). For example: 


*MERGE.....TITLE = ‘Merged polygon file’ 


Ifa TITLE is not specified in the *~*MERGE command, it will be automatically set to 
the title originally allocated to the first input file. 


MINCOL,MAXCOL 
These parameters may be used to reduce the length of segment labels and are 
similar to MINCOL, MAXCOL and CULDESAC in *POLYGON (see Section 5.1.0.0). 
For example, if aSegment file contained zones labelled AO1ACBG and AOD1ACAY, 
the following command would reduce labels to AO1AC: 
MINCOL= 1 MAXCOL= 5 


In addition, segments which have the same name on either side will be 
automatically excluded from the output file. 


REDUCE 
This parameter may be used to generalise segment files. A detailed explanation 
of the effect of REDUCE is given in Section 5.1.0.0. 

CHANGE 
This parameter may be used to specify up to 100 name changes for segments. For 
example: 


CHANGE 201 CD01 202 CD02 


would rename segments Z01 and Z02 as CD01 and CDO2 respectively. 


INCLUDE, EXCLUDE, LOWNAME, HIGHNAME 


These parameters may be used to include or exclude segments from the merged 
file. For example. 


*MERGE....EXCLUDE LOWNAME CD72 


will exclude all segments referenced with a name alphabetically less than CD72. 
Similarly, the command: 


*MERGE....EXCLUDE HIGHNAME CD72 


will exclude all segments referenced with a name alphabetically greater than 
CD72. 


INCLUDE has the reverse effect. For example: 
*MERGE....INCLUDE LOWNAME CD72 


will include only those segments referenced with a name alphabetically less than 
than CD72. 


Examples of *MERGE 
EXAMPLE 1 


*FILEPARM 11 'POLY1' GIMMS 

*FILEPARM 12 ‘POLY2’ GIMMS 

*FILEPARM 13 ‘POLYMERG' GIMMS 
“UTILITIES 


*MERGE FILEIN= 11,12 FILEOUT = 13 
FILENAME = MERGPOLY 
TITLE = ‘Merged file from POLY 1 and POLY2' 
*END 
*STOP 


This GIMMS command run merges the Polygon files assigned to channels 11 and 
12 and outputs results to the new Polygon file assigned to channel 13. 


EXAMPLE 2 


*FILEPARM 11 'SHEET1' GIMMS 

*FILEPARM 12 'SHEET2’ GIMMS 

*FILEPARM 13 ‘SHEETA’ GIMMS 
*UTILITIES 


*MERGE FILEIN = 11,12 FILEOUT = 13 
EXCLUDE HIGHNAME = SHEETO 
*END 
*STOP 


This GIMMS command run merges the Segment files assigned to channels 11 and 
12 and, in the process, deletes all segment referenced with a name alphabetically 
greater than SHEETO. 


9.6.0.0 *~*MODCENT COMMAND 


This command is used to change the position of selected centroids within a GIMMS 
Polygon file. For example. 


*FILEPARM 11 ‘POLYGON1' GIMMS 
*FILEPARM 12 'POLYGON2’ GIMMS 
“UTILITIES 


*MODCENT FILEIN= 11 FILEOUT = 12 
ZONE A012A4 CENTROID = 625150, 201327 
ZONE B152X9 CENTROID = 417932, 372143 
*END 
*STOP 


This GIMMS command run would use the polygon file assigned to channel 11 to 
generate a new polygon file on channel 12 with centroid positions for zones A012A4 
and B152X9 set to the coordinate values specified. 


FILEIN, FILEQUT, ZONE, and CENTROID will normally be specified explicitly but values 
for the other parameters may be supplied in one of three ways: 


1)  byspecifying absolute coordinates in MAPUNITS (see example above). 

1) by measuring from a paper copy of a map generated by the commands 
*DRAWMAP or *MAP (see Section 6.1.3.2 and Section 6.1.3.3). This method 
uses the parameters ABSOLUTE, RELATIVE, SCALE, and ORIGIN. 

ii) by plotting the polygon on a graphic screen and indicating the new 


position for the centroid using the graphic cursor. This method uses the 
parameters PLOT and DRAW. 


Within *MODCENT the following parameters are available: 


FILEIN (FILE) (IN) /\/ specifies input channel 

FILEOUT (OUT) /\/ specifies output channel 

PLOT /K/ plots zones on graphic screen 

SCALE /R, = 1.0/ specifies scaling factor for plot 

ORGX (ORIGIN) /R/ specifies origin shift for plot- X value 

ORGY /R/ specifies origin shift for plot - Y value 

ABSOLUTE /K/ specifies new position relative to map 
origin 

RELATIVE /K/ specifies new position relative to 
existing centroid 

ZONE (Z) /L/ selects zone to be modified 

DRAW (D) (N) (NEXT) /K/ draws next zone (used with PLOT) 

CENTX (CX) (CENTROID) /R,:P/ specifies X-coordinate for new 
centroid 

CENTY (CY) /R,:P/ specifies Y-coordinate for new 
centroid 


Further Notes on *MODCENT Parameters 

FILEIN, FILEOUT 
These parameters are used to identify the input file and direct output. Both 
parameters MUST be specified. FILEIN identifies the input channel while 
FILEOUT identifies the output channel. For example: 


*“MODCENT FILEIN = 11 FILEOUT = 12 


ABSOLUTE, RELATIVE, SCALE, ORIGIN, ZONE, CENTROID 


These parameters are used when new centroids are being measured from a 
paper copy of a map generated by the commands *DRAWMAP or *MAP (see 
Section 6.1.3.2 and Section 6.1.3.3). 


ABSOLUTE is specified when values for the position of new centroids are 
supplied in centimetres and measured from the map origin; RELATIVE is 
specified when values for the position of new centroids are supplied in 
centimetres and measured from the positions of existing centroids. 


Values for SCALE and ORIGIN are REQUIRED and represent the scaling factors 
output by *GIMMSFILE, *SCALE or *ORIGIN command prior to a *DRAWMAP/ 
*MAP command (see Section 6). For example, when a locational data file is 
plotted the following diagnostic information may be generated: 


COMMAND: *DRAWMAP 

OPTION = NAMES 

OPTION = OUTLINES = ALL 

SCALING FACTORS = 0.005143 0.005143 
ORIGIN SHIFT = 0.000000 2.000000 


FILE NSWPOLY IS BEING PLOTTED 


This information contains appropriate values for the parameters SCALE and 
ORIGIN when used with *MODCENT. 


The parameter CENTROID is used to input the new centroid position in 
centimetres. For example: 


*MODCENT ..... 
ABSOLUTE SCALE = 0.005143, 0.005143 ORIGIN O, 2 
ZONE 20345 CENTROID 10.45 15.67 
ZONE 20492 CENTROID 11.37 13.81 


would reset the centroids for the named zones to be at the points specified . 
Similarly the command: 
*MODCENT ..... 
RELATIVE SCALE = 0.005143, 0.005143 ORIGIN O, 2 
ZONE 20345 CENTROID O.2 1.7 
ZONE 20492 CENTROID -0.35 0.9 


would position the new centroids RELATIVE to their old position. 


PLOT, DRAW, ZONE, CENTROID 


These parameters are used together when centroids are being modified on a 
graphic screen. 


PLOT indicates that selected zones will be plotted on the graphic screen and the 
graphic cursor used to specify new positions for centroids. 


ZONE selects a specific zone, while DRAW plots the zone on the graphic screen. 


When a ZONE label is specified, the input file is searched until the appropriate 
zone is located. The parameter DRAW may then be issued to plot the zone on 
the graphic screen. The position of the existing centroid will be marked by a 
cross and the graphic cursor may be used to indicate the new position. This new 
position will be stored by pressing the space bar. 


If another DRAW command is issued, the next zone will be plotted and the 
process of moving the centroid may be repeated. Alternatively, the parameter 
ZONE may be used to select a specific zone. 


N.B. Zones MUST be selected in the same order as they are stored in the 
locational data file. 


Examples of *MODCENT 
EXAMPLE 1 


*FILEPARM 10 POLYGON’ GIMMS 
*FILEPARM 11 POLYGON2' GIMMS 
*UTILITIES 


*MODCENT FILEIN = 10 FILEOUT = 11 
242 = 3012,/014 273 = 8094,3563 


*END 
*STOP 


This GIMMS command run reads an existing Polygon file from channel 10 and 
creates a new Polygon file on channel 11. Centroids for zones Z42 and Z73 are 
positioned at the points (3012,7014) and (8094,3563) respectively. Values for 
these positions are expressed in map units. 


EXAMPLE 2 


*FILEPARM 10 POLYGON’ GIMMS 
*FILEPARM 11 ‘POLYGON2’ GIMMS 
“UTILITIES 


*MODCENT FILEIN = 10 FILEOUT = 11 
ABSOLUTE 
SCALE = 0.00137 ORIGIN = 2.143,3.72 
242 = 12.27,14.34 273 = 18.17,8.21 
*END 
*STOP 


This GIMMS command run reads an existing Polygon file from channel 10 and creates a 
new Polygon file on channel 11. The parameter ABSOLUTE indicates that new 


positions for centroids will be measured from the origin (i.e. the bottom left corner) of 
a paper map generated by the commands *DRAWMAP or *MAP (see Section 6.1.3.2 
and Section 6.1.3.3). Values for these positions are expressed in centimetres. 


EXAMPLE 3 


This example demonstrates how *MODCENT may be used on a graphic terminal. 
Commands are input one line at a time and executed immediately. 


User Input Explanation 

*FILEPARM 10 ‘POLYGON’ GIMMS <allocates existing GIMMS Polygon 
file to channel 10> 

*FILEPARM 11 ‘POLYGON2' GIMMS <directs new polygon file to channel 
11> 

*UTILITIES <accesses *UTILITIES module > 

*MODCENT FILEIN = 10 FILEOUT = 11 <identifies input and output 
channels > 

PLOT <indicates that zones will be plotted 
on the graphic screen > 

ZONE = 242 <selects zone > 

DRAW <plots zone on graphic screen > 


<switches on graphic cursor > 

< move cursor to new centroid position and hit space bar> 

NEXT : <selects and plots next zone in 
locational data file and switches on 
graphic cursor > 

< move cursor to new centroid position and hit space bar> 

ZONE = 273 DRAW : <selects specific zone by label and 
plots on graphic screen and switches 
on graphic cursor > 

<move cursor to new centroid position and hit space bar> 

*END <exits from *UTILITIES > 

*STOP <terminates GIMMS command run> 

In this GIMMS command run, the position of centroids for three zones have been 


modified. ZONEs are specified in the same order as the polygons are stored in 
the existing locational file. 


9.7.0.0 *SAVE AND *RESTORE COMMANDS 


These commands may be used to save or restore non-locational DATA files or GRID 
files. 


Although not generally required, these commands may be of use to some machine 
implementations where normal DATA or GRID files are pre-configured to their 
maximum size. *SAVE will write the contents of a DATA or GRID file to a standard 
sequential file and this may save space. *RESTORE will be required to make this data 
available on subsequent GIMMS command runs. The *SAVEing and *RESTOREing of 
data uses CPU resources and should only be used where necessary. 


Within *SAVE and *RESTORE the following parameters are available: 


DATAFILE (DATA) /K/ selects non-locational DATA file 

GRIDFILE (GRID) /K/ selects GRID file 

FROM /K/ no effect, used for linkage 

TO /K/ no effect, used for linkage 

FILE (FILEOQUT) (OUT) (FILEIN) (IN) /\/ specifies input or output 
channel 


When *SAVE is used, output is directed to a specific channel number using the 
parameter FILE; when *RESTORE is used, input is read from a specific channel number 
using the parameter FILE. For example: 


*SAVE DATAFILE TO FILE 13 
saves output to channel 13: 
*RESTORE DATAFILE FROM FILE 11 
restores input from channel 11. 


N.B. *SAVE and *RESTORE have been largely replaced by the commands *FILEPARM 
DATA and *FILEPARM GRID (see Section 3.3.1.2). 


9.8.0.0 *TERMINAL COMMAND 


This command is used to configure individual terminals and allows users, or the 
installation, to specify terminal characteristics. Such information ts required before 
GIMMS menu mode can be selected (see Section 3.3.1.1 under MODE). 


The terminal characteristics are stored in a User Macro Library or in the System Macro 
library and it is assumed that the main screen functions can be controlled by a series of 
codes. These functions include: 


)  clearscreen 
(ii)  clearto end of line 
i) clearto end of screen 
)  dtrect cursor addressing using binary or character codes 


*TERMINAL is used in association with the command *SYSPARM TERMINAL (see 
Section 3.3.1.1 under TERMINAL). 


Within *TERMINAL the following parameters are available: 


NAME /L/ specifies name of terminal driver 

SYSTEM /K/ specifies terminal driver should be stored in System Library 
NOSTORE /K/ specifies terminal driver should not be stored 

CLRSCR /M/ specifies clear-screen sequence (terminated by -1) 

CLREOL /\/ specifies clear-to-end-of-line sequence (terminated by -1) 
CLREND /\/ specifies clear-to-end-of-screen sequence (terminated by -1) 
GOTOXY A/ specifies direct cursor-addressing sequence (terminated by -1) 
BASEX /\/ specifies base value to add to X to obtain range 1 to 80 
BASEY /\/ specifies base value to add to Y to obtain range 1 to 24 
YTHENX /K/ outputs Y before X 

DECOUT /K/ selects decimal rather than binary output 

SEPXY /\/ specifies separator between X and Y (terminated by -1) 
ENDXY |\/ ends sequence for direct cursor (terminated by -1) 

Code Sequences 


Codes for the various sequences should be specified as decimal values of the 
appropriate character codes. For example: 


27 91 50 74-1 


means the escape character (code = 27) followed by the sequence [2) (where [= 91, 
2= 50 and J= 74) and ts the VT100 clear screen sequence. All sequences should be 
terminated by a value of -1. 


Further Notes on *TERMINAL Parameters 
NAME 


This parameter specifies a name for the terminal driver. The name may be up 
to 8 characters long, the first of which MUST be a letter. 


If the terminal driver is to be stored in a macro library, the name is automatically 
prefixed by the characters 'T ... For example, the driver VT100 would be stored 
as T.VT100. 


SYSTEM 
Generally, the terminal set-up will be stored in the User Macro Library. If it is 
required to store the set-up in the System Macro Library this parameter should 
be specified. 


N.B. The System manager is generally the only person who can add macros to 
the System Library. 
NOSTORE 
This parameter specifies that a terminal driver is temporary and should not be 


stored. The driver will only be available for the duration of the current GIMMS 
run or until another *TERMINAL or *SYSPARM TERMINAL command is issued. 
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CLRSCR,CLREOL,CLREND 


These parameters are used to define how to clear the terminal screen. CLRSCR is 
used to completely clear the screen; CLREOL is used to clear the screen from the 
current position of the cursor to the end of the line; CLREND is used to clear the 
screen from the current position of the cursor to the end of the screen. 


CLRSCR should return the cursor to the top left corner of the screen; CLREOL and 
CLREND should leave the position of the cursor unchanged. 


N.B. If a particular terminal does not support a clear screen facility, then a 
combination of these functions may be used. For example, the cursor may 
be moved to the top left of the screen and the function sequence for 
CLREND specified. 


GOTOXY,BASEX,BASEY,YTHENX,DECOUT, SEPXY, ENDXY 


These parameters are used to address the cursor. The way in which this is 
achieved depends on the particular terminal being used but in general the 
following sequence Is employed: 


)  astarting sequence (specified by the parameter GOTOXY), 

(ji) anXoryY sequence, 

ili) asequence separating X and Y (specified by the parameter SEPXY), 
) another X or Y sequence 

) a final sequence (specified by the parameter ENDXY) 


Notes 


1) Generally, the X sequence (i.e. the column number) precedes the Y 
sequence (i.e. the row number) but when the parameter YTHENX is 
specified this order is reversed. 


2) Mand Y sequences encode row or column numbers and may be supplied as 
binary characters or as character sequences. in general, binary characters 
are used. However, the parameter DECOUT may be specified to select 
character sequences. For example, if DECOUT had been specified, the code 
for column 42 would not be output as the character ‘*' (i.e. ASCII code 42) 
but as the character sequence '42' (i.e. ASCII codes 52 and 50) 


3) Many terminals using binary codes offset the values for X and Y so that the 
binary codes being sent are printable. The parameters BASEX and BASEY 
allow the user to set the offset value and this will be added to each X or Y 
values prior to output. 


Examples of creating terminal drivers 
The following commands create two terminal drivers. The first relates to a Hazeltine 


Esprit terminal and the second to a DEC VT100. In addition, the driver for the VT100 
conforms to ANSI standards. 


EXAMPLE 1 - Driver for Hazeltine Esprit 


*TERMINAL SYSTEM NAME = ESPRIT 


CLRSCR = 2728-1 
CLREOL = 2715-1 
CLREND = 2723-1 
GOTOXY = 2717-1 
BASEX = 0 
BASEY = 31 


EXAMPLE 2 - Driver for DEC VT100 


*TERMINAL SYSTEM NAME =VT100 


CLRSCR = 27915074-1 
CLREOL = 27914875-1 
CLREND = 27914874-1 
GOTOXY = 2791-1 
YTHENX DECOUT 
SEPXY = 59-1 

ENDXY = 72-1 

BASEX =0 

BASEY =0 


N.B. The control codes specified for *TERMINAL in relation to a particular terminal 
type can be stored as a GIMMS macro and located in a User Library or in the 
System Library. It may then be accessed in subsequent GIMMS command runs 
using the command *SYSPARM TERMINAL (see Section 3.3.1.1). 


9.9.0.0 *~MACRO COMMAND 


This command ts used to specify GIMMS macros. These may be stored in User Macro 
Libraries or in the System Macro Library and are accessed using the command *CALL 
(see Section 9.10.0.0). 


The creation of macros is a complex procedure and is fully described in the ‘GIMMS 
Macro Guide’ (Carruthers, 1988), published by GIMMS Ltd., Edinburgh. 


A GIMMS macro has three parts: 
- The Macro Name and the Library in which it resides 
- The Parameter Definitions (if appropriate) 
- The Stored GIMMS Command Sequence 
The use of these are illustrated in the following example macro: 
*MACRO NAME = TESTMACRO 
PEN ALIASES = COLOUR, COLOUR, COULEUR TYPE = INTEGER 
DEFAULT = 1 PROMPT = ‘Pen colour’ 


HELP = ‘Select pen colour from 1 to 8 / 


MACRO = '*PEN $PEN *' 


The macro created is called TESTMACRO. A single parameter has been defined and is 
called PEN, COLOR, COLOUR or COULEUR. This parameter has a default setting of pen 
colour 1 and appropriate menu and help information. 


Macro TESTMACRO would be accessed from a GIMMS command run and pen colour 5 
selected by the command: 
*CALL TESTMACRO PEN = 5* 


Parameters available within *~MACRO will be considered under three headings. 


1. The Macro Name and the Library in which it resides 


SYSTEM /K/ stores macro in System Library 
MACNAME (NAME) /U/ specifies macro name 
HELP (HELPINFO) /S/ specifies general help information 


N.B. When amacro Is being described this first part MUST be terminated by a 
slash (/). 


Further Notes on *MACRO Parameters 
SYSTEM 
When a macro is created it will, by default, be stored tn a User Macro Library. 
However, if this parameter is specified the macro will be stored in the System 
Macro Library. For example: 
*MACRO SYSTEM... 
N.B. The system manager is generally the only person who can add macros to 
the System Library. 
MACNAME 
This parameter is used to allocate a name to a macro. For example: 


*MACRO SYSTEM MACNAME = MAC1 


This command would store a macro called MAC1 in the System Library. If a 
macro of this name already existed in the Library, it would be overwritten. 


N.B. Macro names may be up to 8 characters long, the first of which MUST be 
a letter. 
HELP 


This parameter may be used to include general help information about the 
macro. For example: 


*MACRO NAME = MAC1 
HELP = ‘Example Macro’ /.... 


Help information MUST be enclosed by primes (''). 

N.B. When amacro is being described this first part MUST be terminated by a 
Slash (/). 

The Parameter Definitions 

Each parameter slot in a macro consists of a keyword, any alias names, a type, 

possibly a default value, a short descrip: on, and help information. Generally, 


these are issued in a specific order so that values are interpreted by GPIS (see 
Section 2.2.2.0). 


NAME /L/ specifies macro parameter name 

ALIASES (ALIAS) /L,REPEAT =20/ specifies alias names 

INTEGER (I) /K/ specifies macro parameter type as 
integer 

REAL (R) /K/ specifies macro parameter type as real 

LABEL (L) /K/ specifies macro parameter type as label 

STRING (S) /K/ specifies macro parameter type as string 

CURSORP (RP) /K/ specifies real position - cursor settable 

CURSORD (RD) /K/ specifies real distance - cursor settable 

CURSORA (RA) /K/ specifies real angle - cursor settable 

EXPRESSION (E) /K/ specifies macro parameter type. as 
expression 

VECTOR (RV) /K/ specifies macro parameter type as real 
vector 

PVECTOR (RVP) /K/ specifies real vector type - plottable 

KEYWORD /K/ specifies macro parameter type as 
keyword 

DEFAULT /,R,or L/ specifies default value for integer, real, 
or label macro parameters 

PROMPT /S/ specifies short description of macro 
parameter for menu mode 

HELP (HELPINFO) /S/ specifies macro parameter help 
information 

END (QUIT) (MACRO)/K/ terminates description of macro 
parameters 


Further Notes on *MACRO Parameters 
NAME, ALIASES 


These parameters are used to provide a name and a list of up to 20 alias names 
fora Parameter Definition. For example. 


*MACRO NAME = MAC1 
HELP = ‘Example Macro’ / 
NAME = PEN ALIASES = COLOUR, COLOR.... 


A macro called MAC1 would be created by the above command. This macro 
would would include a parameter called PEN whose alias names are COLOUR and 
COLOR. 


N.B. Parameter NAMES and ALIASES may be up to 10 characters long, the first 
of which MUST be a letter. 


TYPE, INTEGER, REAL, LABEL, STRING, CURSORP, CURSORD, CURSORA, 
EXPRESSION, VECTOR, PVECTOR, KEYWORD 


These parameters may be used to specify the TYPE of macro parameter being 
defined. For example: 


*MACRO NAME = MAC1 
HELP = ‘Example Macro / 
NAME = PEN ALIASES = COLOUR, COLOR TYPE = INTEGER... 


In the above command the macro parameter PEN ts defined as INTEGER. 


A description of the different types of parameters available is presented in 
Section 2.2.3.1. 


DEFAULT 


This parameter may be used to include a default value for a macro parameter 
defined as type INTEGER, REAL or LABEL. For example: 


*MACRO NAME = MAC1 
HELP = ‘Example Macro’ / 
NAME = PEN ALIASES = COLOUR, COLOR TYPE = INTEGER 
DEFAULT = 2...... 


The DEFAULT value will be used if the macro parameter is NOT assigned when 
the macro is accessed in subsequent GIMMS command runs using the command 
*CALL (see Section 9.10.0.0) 


PROMPT 


This parameter may be used to provide a short description for macro parameters. 
For example: 


*MACRO NAME = MAC? 
HELP = ‘Example Macro’ / 
NAME = PEN ALIASES = COLOUR, COLOR TYPE = INTEGER 
DEFAULT = 2 
PROMPT = ‘Pen colour’.... 


N.B. PROMPT information must be enclosed by primes ("’). 


The information stored by PROMPT will be printed on the terminal screen if a 
macro is accessed while GIMMS is operating in menu mode (see Section 3.3.1.1 
under MODE). 


HELP 


This parameter may be used to include help information for a macro parameter. 
For example: 


*MACRO NAME = MAC1 
HELP = ‘Example Macro’ / 
NAME = PEN ALIASES = COLOUR, COLOR TYPE = INTEGER 
DEFAULT = 2 
PROMPT = ‘Pen colour’ 
HELP = ‘Specify pen number from 1 to 8’.... 


N.B. HELP information must be enclosed by primes ("’). 


The information stored by HELP will be printed on the terminal screen if a macro 
is accessed and the command HELP is specified while GIMMS is operating in 
menu mode (see Section 3.3.1.1 under MODE). 


END 
This parameter terminates the Parameter Definitions list. For example: 


*MACRO NAME = MAC2 
HELP = ‘Example Macro’ / 


NAME = PEN1 ALIAS = FIRST TYPE = INTEGER 
DEFAULT = 1 

PROMPT = ‘First pen colour’ 

HELP = ‘Specify pen number from 1 to 8' 


NAME = PEN2 ALIAS = SECOND TYPE = INTEGER 
DEFAULT = 4 
PROMPT = ‘Second pen colour 
HELP = ‘Specify pen number from 1 to 8’ 
END 
The GIMMS command sequence to be stored in the macro may then be defined. 
N.B.  \In practice, the parameter END is omitted as it is overridden by the 
parameter MACRO (see below). 
The Stored GIMMS Command Sequence 
MACRO (DESCRIPT) /S/ specifies GIMMS command sequence 


This parameter is followed by the GIMMS command sequence to be stored in the 
macro. Forexample: 


*MACRO NAME = MAC3 
HELP = ‘Point symbolism’ / 
MACRO = '*SYMBOLISM POINT SQUARE SHADE 
xk? 


The GIMMS command sequence MUST be enclosed by primes ("’). 


If parameters are included within a macro, a dollar symbol is used to indicate 
where a value should be substituted. For example: 


*MACRO NAME = MAC2 
HELP = ‘Example Macro’ / 


NAME = PEN1 ALIAS = FIRST TYPE = INTEGER 
DEFAULT = 1 

PROMPT = ‘First pen colour’ 

HELP = ‘Specify pen number from 1 to 8 


NAME = PEN2 ALIAS = SECOND TYPE = INTEGER 
DEFAULT = 4 

PROMPT = ‘Second pen colour’ 

HELP = ‘Specify pen number from 1 to 8' 


MACRO = '*SYMBOLISM AREA 
SPACING = 0.7 PEN = $PEN1/ 
SPACING = 0.2 PEN = $PEN2 


N.B. It is advisable to terminate the GIMMS command sequence with an 
asterisk (*). 


Within the stored GIMMS Command Sequence it is possible to *CALL another 
macro. This condition is known as nesting. For example: 


*MACRO NAME = MACMAP / 
NAME = VAR TYPE = LABEL PROMPT = ‘Variable Name’ 
MACRO = '*LEVELS = 4 
*CALL MAC3 * 
*MAP VARIABLE = $VAR POINT 
53 


N.B. Macro MAC3 must already exist and be stored in the same User Library as 
MACMAP or in the System Library. 


Further examples of macros are given in the 'GIMMS Macro Guide’ (Carruthers, 1988), 
published by GIMMS Ltd., Edinburgh. 


9.10.0.0 *CALL COMMAND 


This command accesses GIMMS macros and may be used to specify values for available 
macro parameters. 


Within *CALL the following parameters are available: 


INTERACT /K/ generates screen menu for nested macro 
DEFAULT /K/ sets new default values for nested macros 
MACRO (NAME) /L/ specifies macro name 


Further Notes on *CALL parameters 

MACRO 
This parameter specifies the name of the macro to be accessed. For example: 

*CALL MACRO = MAC3 * 

N.B. The *CALL command should be terminated by an asterisk (*). 

INTERACT 
In general, when a macro is *CALLed, processing of the stored GIMMS command 
sequence is invisible to the user. The parameter INTERACT however, may be used 
with nested macros to interrupt processing and allow the user to specify values 
for parameters using GIMMS menu mode. 
For example, a macro called PENCHOICE may be defined with a parameter called 
PEN to select pen colour. If a macro called SETSYMBOL accessed PENCHOICE, the 
value for PEN would be determined by SETSYMBOL. The usual way to do this Is to 
specify PEN as a parameter in SETSYMBOL and pass the value in to PENCHOICE. 


For example: 


* MACRO NAME = SETSYMBOL / 
PEN INTEGER =1 ‘Penchoice'/ 


MACRO = * 
“CALL PENCHOICE PEN = $PEN * 
‘! 
Including the parameter INTERACT within SETSYMBOL however, when the 
macro is *CALLed, would force PENCHOICE to display a screen menu and wait for 


the user to input a value for PEN before resuming processing. For example: 


*CALL INTERACT PENCHOICE * 


DEFAULT 


The default value for PEN appears on the screen when the command *CALL 
INTERACT PENCHOICE * is processed. By specifying the parameter DEFAULT 


however, the default value for PEN may be modified BEFORE the menu appears on the 
screen. For example: 


*CALL INTERACT DEFAULT PENCHOICE PEN = 4 * 
This command would display the menu for PENCHOICE on the screen but the 


default setting for PEN would be 4. In this way, nested macros may be tailored to 
suit particular requirements. 
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APPENDIX A 
SPECIFYING TEXT STRINGS 


A text string which is to be plotted is a sequence of typed characters enclosed within 
primes ('). Forexample: 


‘THIS IS A TEXT STRING’ 


When the text is plotted, the enclosing primes will be omitted. Everything that is 
typed within the primes will be plotted except where the special symbols are involved. 
The special symbols are the prime ('), the plus sign ( +) and the at sign (@). 


Figure 6.5 shows the use of strings in the text command. 


PRIME (’) 


Since the prime is the delimiter for the text string then it cannot be included as a 
normal character. If it is wished to use the prime in a text string then it should be 
represented by two primes in sequence. For example: 


‘PRODUCED BY "FRED'" 
would be plotted as 


PRODUCED BY ‘FRED’ 


PLUS (+) 


It is sometimes required to output a longer string of text than can be input on one 
line. This is achieved by putting a plus character as the last printed character ona line. 
The plus will be ignored and plotting will continue at the position where the plus 
occurred. For example: 


‘THIS IS A TEST OF + 
LINE EXTENSION’ 


would be plotted as 


THISISA TEST OF LINE EXTENSION 


AT (@) 


The @ sign is used to specify special action to be taken when plotting text strings and 
is always followed by a letter or a number to denote the action to be taken. Both the 
@ sign and the letter or number are ignored for plotting purposes. If the letter or 
number is not a valid action, no error will be given and no special actions will be taken. 
lf the @ sign is required to be used as a plotted character, then it should be 
represented by two @ signs. For example: 


‘THIS IS AN @@ SIGN' 


would be plotted as 

THIS IS AN @ SIGN 
Each of the modes selected by the @ control (except for the special characters) stays in 
force for that text string unless changed or cancelled by the @R control. Each text 
string is considered as completely separate. 


SPECIAL CHARACTERS 


@C is taken as a carriage return with no line feed. That is, subsequent text will start 
at the same point as the current line. For example: 


‘A BC@CDEF' will be plotted as ADBECF 
‘ABC@Cc ' will be plotted as ABC 


The above examples may not work with special alphabets since the character 
sizes may differ. 


@B is replaced by a backspace character so that the next character plotted will be 
plotted over the last one. For example: 


‘000@B will be plotted as 000 
It should be noted that a second or subsequent backspace always moves back a 
full character place and therefore a second or subsequent backspace character 
may move slightly further back than the beginning of the appropriate character 
if variable width characters are being used. 
@( will produce the character [ 
@) will produce the character ] 


@- will produce the character __ 


@/ will produce the character \ 


ACCENTS 


Certain codes have been identified to provide access to accents, primarily those of the 
French language. These codes are as follows: 


Actual ASCIi code selected 


Accent Code Upper case Lower case 
Aigue @< 19 20 
Grave @> 21 22 
Circumflex @* 23 24 
Tierne @: 25 26 
Omlat @ 27 28 
Cydille @? 29 30 


The definitions of these characters are not available for all alphabets (see Appendix B, 
Alphabet Tables). Thus, for example, @<e would produce é. 


N.B. Alphabets 80 and 81 contain virtually all of the accent combinations in European 
languages. 


CHARACTER SET 


The GIMMS system operates internally using the ASCII character set and all the 
characters defined in the ASCII set can be produced. Many devices for input however, 
do not allow facilities to input all the characters, for example, lower case letters. 
GIMMS provides facilities to make full use of the character facilities with only standard 
input facilities by providing controls to switch between different parts of the GIMMS 
character set. 


@L switches the text into lower case mode. This means that al! characters between 
ASCII codes 64 and 95 will reproduce character codes 96 to 127 (see Appendix B, 
Alphabet Tables). In particular it can be used to produce lower case letters. For 
example: 


‘T@LEST TEXT’ 
is equivalent to Test Text’. 


@U resets the text into the standard character set which is composed of upper case 
letters and a selected set of symbols. If the input device can input lower case 
characters and the operating system does not change them, then GIMMS will 
also produce lower case letters in this mode. 


It should be noted that the @L@U combination is a cumbersome way to define upper 
and lower case letters. It is much preferable to enter in upper and lower case directly 
at the keyboard. 


@E selects instead of the specified character following, the corresponding character 
in the range 1-31 of the ASCII set. This only has the effect for that character. For 
example, @ED would produce the square root character if alphabet 13 was 
selected. Page B.3 contains all the @E characters. 


If, for some reason, GIMMS does not have a symbol for the character provided to the 
plot routine then a standard symbol (see Alphabet Tables, e.g. code 1) is produced. It 
should be noted however that the GIMMS input/output package will transform all 
unknown characters into the DELete character (see Alphabet Tables, code 127) so that 
such a character will produce the delete symbol. 


SELECTION OF ALPHABETS @nn 


The selection of an alphabet (see Appendix B) may be made within a string by coding 
the @ sign followed by the two digit alphabet number. For example, @52 would 
select alphabet 52. It should be noted that not all alphabets have a complete 
character set and if a character is specified that does not exist in that alphabet, then 
the default alphabet is used instead. 


The use of alphabets 1-9 is special in that they contain special characters. If a selection 
of an alphabet between 1 and 9 is made, it only applies to the next character defined 
and reverts to the preceding alphabet immediately after. Thus the string: 


‘ABCD@02XEFGH' 


will draw ABCD in the initially selected character set, the character in the X position 
from alphabet 2, and the characters EFGH in the alphabet initially selected. 


To ease the use of this feature it is not necessary to specify a two digit alphabet 
number as long as there is no conflict. For example, @2X has the same effect as @02X 
but if the base character is a digit itself, for example, the character in the 7 position in 
alphabet 2, the effect of coding @27 would of course, select alphabet 27. 

PEN SELECTION @Pn 


The pen being used may be changed within a string by using the @P code. For 
example: 


‘Test @P2 Text’ 
would cause the ‘Test’ to be plotted in the initial pen colour and ‘Text’ to be plotted in 
pen 2 colour. Only pens 0-9 may be accessed in this way. 


CHARACTER SIZE 


The text plotting routines can produce 3 sizes of character, half size, full size, and 
double size. 


@H makes subsequent characters half size. These characters are half size in every 
respect and it applies to all characters including the new line character and back 
space. Thus if the @H switch is on when text moves to a new line, that new line 
will be half the distance below the previous line than a full new line. 


@D makes subsequent characters double size and therefore 4 times the size of half 
size characters. All characters are affected. 


@F makes subsequent characters into full sized, or normal sized characters. This is 
the default character size. 


CHARACTER SHAPE 


@!i causes subsequent characters to be drawn in italic, or slanted, mode. All 
characters will be slanted, normally, to the right. 


@V causes all characters to be drawn in vertical, or normal mode. This is the default 
character shape. 


CHARACTER POSITION 


The text plotting routines allow the use of superscript and subscript characters. These 
are especially useful in conjunction with half size characters. Each line of text is 


A-4 


considered to have a text base line. Superscript text is drawn on a line a half character 
high above the base line. Subscript text is drawn a similar distance below the base 
line. ; 


@S selects superscript mode and all characters are drawn a half character height 
above the text base line. Note that the half character height depends on the size 
mode currently selected. For example, if half size characters are being drawn 
then the superscript characters will only be one quarter of a normal character 
height above the base line. 


@T selects subscript mode and all characters are drawn a half character height below 
the text line. The current character size also affects this mode. 


@N selects normal mode and text will be drawn along the text base line. This is the 
default setting for character position. 


This option is most useful in conjunction with half size characters. If @S@H is selected 
then subsequent characters will occupy the top half of the normal character space. 
Note that if @H@S had been input then subsequent text would occupy the middle 
half (one quarter to three quarters) of the character space since the superscript had 
been done on the half character size. Subscript mode operates in the same way. 


RESET 


@R_ will reset all defaults for text plotting. It is equivalent to @U@F@V@N. It does 
not have any effect on alphabet selection or pen colour. 


OTHER FUNCTIONS 


@_or@Z This facility provides the capability of controlling underlining in text 
strings and has different effects depending on whether UNDER has been 
specified in the *TEXT command. There are two forms of this code; single and 
multiple use. 


Single use of @Z 

If asimple @ or @Z (hereafter just referred to as @Z) is placed anywhere on a 
line of text and UNDER has not been specified then the whole line will be 
underlined. If UNDER (i.e. underline whole string) has been specified then 
underlining 1s ignored for this line if the @Z code is given. 


For example: 


TT EXT. 22nx. ‘TEST would be plotted as TEST 
OF@Z OF 
UNDERLINE’ UNDERLINE 
and 
*TEXT ... UNDER‘'TEST would be plotted as TEST 
OF@Z OF 
UNDERLINE’ UNDERLINE 


Multiple use of @Z 


If a pair of @Z codes are given ona line then underlining will occur between these 
points if UNDER has not been specified or omitted 1f UNDER has been specified. 
For example, the command 


*TEXT ...... TEST @ZOF@Z UNDERLINE’ 


would be plotted as TEST OF UNDERLINE 


and *TEXT .. UNDER 'TEST@Z OF @ZUNDERLINE' 


would be plotted as TEST OF UNDERLINE 


@) If JUSTIFY or RIGHT has been specified in the *TEXT command and an @)I code is 
placed at the beginning of a line then there will be no justification of that line. 


Character mode summary (using @ sign) 


Special characters 


Character set 


Character size 


Character shape 


Character position 


Pen selection 


Reset 


@Pn 
@R 


carriage return 
backspace 


= \- 
@>,@* @:,@# ,@? accents 


lower case mode 
extended char.set 
upper case 

select alphabet nn 


half size 
double size 
fullsize (normal) 


italic (or slanted) 
vertical (normal) 


superscript 
subscript 
normal 


select penn 


reset all defaults (= @U@F@VQ@N) 


N.B. Different results will occur depending on order (e.g. @S@H is not equivalent to 


@H@S) 


APPENDIX B 

GIMMS ALPHABETS 
The basic alphabets provided by the GIMMS system are: 

(1) The default GIMMS alphabet 

(2) The ‘Hershey’ alphabets 

(3) Other alphabets 
These alphabets are illustrated in the tables of 'GIMMS alphabets’ 
(1) The default GIMMS alphabet 
This alphabet is a sanserif, single stroke alphabet, containing all of the standard ASCII 
characters. This alphabet is also the base alphabet for other alphabets. For example, 
typing an Aina text string will generally produce the letter A plotted in the selected 
alphabet but it may produce a special character. If an alphabet does not have the 
character selected, then the selected character from this alphabet is used instead. 


(2) The ‘Hershey’ alphabets 


These alphabets are the reordered set of the alphabets created by A.V. Hershey and 
provided by the U.S. National Bureau of Standards (Wolcott and Hilsenrath, 1976). 


Alphabet Description 

2 and 3 Special characters, simplex, single stroke 

4and5 Special characters, complex, double stroke 

6 and 7 Special characters, small complex, double stroke 
11 Sanserif, cartographic, wide simplex, single stroke 
12 Sanserif, simplex, single stroke 

13 Serif, complex, double stroke 

14 Serif, small complex, double stroke 

15 Sanserif, duplex, double stroke 

16 Serif, triplex, triple stroke 

23 Italic, complex, double stroke 

24 Italic, small complex, double stroke 

25 Italic, triplex, triple stroke 

32 Script, simplex, single stroke 

33 Script, complex, double stroke 

51 Gothic, German, triple stroke 

52 Gothic, English, triple stroke 

53 Gothic, Italian, triple stroke 

Notes: a) The difference between complex and small complex is that they are 


designed to be used for different size characters. Complex has more 
points than small complex and the strokes are closer, thereby making it 
more suitable for large characters. Thus if the two types are produced 
at the same size, the small complex will appear thicker and with less 
smooth outlines. 


b) Cartographic (alphabet 11) is a wide simplex alphabet, but is of little 
use since there are no lower case characters. 


(3) Other alphabets 
Please refer to Alphabet Tables for other alphabets. 


The other alphabets have been created especially for GIMMS except for alphabet 17 
which was provided by Lee P Johnston of Santa Clara. All of these alphabets (except 
17) have the capability to be SHADED. See the *TEXT command (Section 6.1.3.4). 


Reference 


Wolcott, NM and Hilsenrath J (1976) 

‘A contribution to computer typesetting techniques: Tables of coordinates for 
Hershey's repertory of Occidental type fonts and graphic symbols’. 

NBS Special Publication 424, April 1976 

Office of Standard Reference Data 

National Bureau of Standards 

U.S. Department of Commerce 
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APPENDIX C 
EXAMPLES OF GIMMS COMMAND SEQUENCES 


The following example command sequences illustrate some of many GIMMS design 
facilities. 


The plotfiles were generated on a VAX 11/750 and plotted on a Hewlett Packard 
7580A plotter. 


It is important to note that the data values used are fictitious and that resulting 
maps/graphs are not necessarily ‘good’ cartographic design. 


U.K. REGIONS 


140000 — 180000 
90000 -< 140000 
54000 -< 90000 





Total Population 





COMMAND SEQUENCE USED TO GENERATE FIGURE C.1 


< Set up file assignments > 


*FILEPARM 11,,'UKPOLY.GIMMS' < Polygon file > 
/DATA,'UKDATA.GIMMS' < Data file > 
/19,'FIGC1.PLT' ,TEXT,OUT < Plotfile, if required > 


< Set up plotter and defaults > 


*PLOTPARM PLOTTER 
*TEXTPARM ALPHABET = 15 


< Enter plotting module > 
*PLOTPROG 
*NEWMAP MAPSIZE = 18,24 FRAME < Set size of map > 
< Identify polygon file > 
*GIMMSFILE FILE = 11 
< Set up the class intervals (with 3 levels) > 


*LEVELS = 3 
*INTERVALS VARIABLE = POP,USER = 54000,90000, 140000, 180000,FREQ 


< Set up three levels of symbolism > 
*SYMBOLISM AREA 
SPACING =0.15,SCREEN 
/ SPACING =0.07,SCREEN 
/ SPACING =0.05 & SPACING = 0.05,ANGLE = 90 PRINT 
< Set up legend and print title > 


* LEGEND POSITION = 11.5,10,SIZE = 0.5 
*TEXT KEY = TOP,TEXT = 'Persons', ALPHABET = 32 


< Draw map using area shading > 
*MAP VARIABLE = POP,MAPTYPE = AREA 
< Specify top and bottom titles > 
*TEXT POSITION = 9.5,22.8, SIZE =0.8, TEXT ='U.K. REGIONS' 
CENTRE ONX ALPHABET = 61,SHADE 
*TEXT POSITION =6,0.5, SIZE =0.7, TEXT ='Total Population’ 
ALPHABET = 16 
*TEXT POSITION =0.2,0.2,SIZE = 0.4,'Figure C.1' ALPHABET 15 
*END < Leaves the *PLOTPROG module > 


*STOP < Terminates the GIMMS run > 
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COMMAND SEQUENCE USED TO GENERATE FIGURE C.2 
< Setup file assignments > 
*FILEPARM 11,,'UKPOLY.GIMMS' < Polygon file > 
/ DATA, UKDATA.GIMMS' < Data file > 
/19,'FIGC2.PLT',TEXT,OUT < Plotfile, if required > 
< Set up plotter and defaults > 


*PLOTPARM PLOTTER 
*TEXTPARM ALPHABET = 15 


< Enter plotting module > 
*PLOTPROG 
< Define map size > 
*NEWMAP MAPSIZE = 24,18 FRAME 
< Identify polygon file and scale study area > 


*GIMMSFILE FILE = 11 
*SCALE SIZE = 10,18 


< Set intervals for the default 5 levels > 
*INTERVALS VARIABLE = POP, TYPE = ROUNDED, FREQ 
/VARIABLE = MANUF, TYPE = ROUNDED, FREQ 
< FREQ draws frequency histogram > 
< Reset shading levels 1-3 > 
*SYMBOLISM AREA 
SPACING =0.15,SCREEN 
/ SPACING =0.07,SCREEN 
/ SPACING =0.05 & SPACING = 0.05, ANGLE = 90, PRINT 
< Set legend parameters and draw legend title > 


* LEGEND POSITION = 0.1,6.8, SIZE = 0.5, CLASS 
*TEXT KEY = TOP, ‘Persons’, ALPHABET = 15 


< Draw map and print title > 


*MAP VARIABLE = POP, MAPTYPE = AREA 
*TEXT POSITION = 2,0.2, ‘Population’, ALPHABET = 16 


< Draw frequency histogram for first map > 


*BARGRAPH SAMEPAGE VAR =POP, ORIGIN = 6.5,11.5, LENGTH = 2,3 
SHADE FREQ CLASSES NOXLABEL NOXTICS NOXSTICS 


< Draw second map > 


< Shift the study area > 
*ORIGIN SHIFT = 8,0 
< Redefine legend and print legend title > 


* LEGEND POSITION = 19,6, SIZE =0.5, CLASS 
*TEXT KEY = TOP, ‘Manufacturing’, ALPHABET = 15 


< Draw second (i.e. right-hand) map and title > 


*MAP VARIABLE = MANUF, MAPTYPE = AREA 
*TEXT POSITION = 10,0.2, ‘Manufacturing’, ALPHABET = 16 


< Draw frequency histogram > 


*BARGRAPH SAMEPAGE VAR = MANUF, ORIGIN = 19,2, LENGTH = 2,3 
SHADE FREQ CLASSES, NOXLABEL, NOXTICS, NOXSTICS 


< Draw major bargraph > 

*BARGRAPH SAMEPAGE VARS = POP,MANUF, ORIGIN = 16,11.5, LENGTH = 7.5,5 

SHADEGRP = 1,3,XUNITS = 1,YMIN = 0,YMAX = 200000 

XLABELS = 'WL','SW','SE’,"EA',"WM','EM', 'NW','NE','N','SC’ 

< Specify main title and draw North Arrow > 
*TEXT POSITION = 4.2,17, SIZE =0.6,'U.K. REGIONS’ 
ALPHABET = 61, SHADE 

*NORTHPT POSITION = 9.5,7.5, SIZE = 1.5, NDRAW, WIDTH =0.8 


*TEXT POSITION = 23.8,0.2, SIZE = 0.3, ‘Figure C.2' 
ALPHABET = 16, RIGHT JUSTIFY ONX 


*END < Leaves the *PLOTPROG module > 


*STOP < Terminates the GIMMS run > 
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U.K. REGION 


WL SW SE EA WMEM NWNE N SC 


Manufacturing 





Manufacturing 


Dulation 





< Draw main title > 


*TEXT POSITION = 10,22.8, SIZE =0.8, TEXT ='U.K. REGIONS’ 
ALPHABET = 62, SHADE, CENTRE ONX 


< Specify subsidiary title > 


*TEXT POSITION = 1.5,0.5, SIZE =0.7, ‘Population/Manufacturing' : 
ALPHABET = 32, REPEAT =4 < REPEAT thickens the text > ( : 


*TEXT POSITION = 17.8,0.2, SIZE = 0.4, ‘Figure C.3' 
RIGHT JUSTIFY ONX 


*END < Leaves the *PLOTPROG module> 


*STOP < Terminates the GIMMS run > 





U.K. REGIONS 


200000 
160000 ee 
oe MANUFACTURING] [:::: 
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COMMAND SEQUENCE USED TO GENERATE FIGURE C.3 


< Set up file assignments > 


*FILEPARM 11,'UKPOLY.GIMMS' < Polygon file > 
/DATA,’'UKDATA.GIMMS' < Data file > 
/19,'FIGC3.PLT',TEXT,OUT < Plotfile, if required > 


< Set up plotter and defaults > 


*PLOTPARM PLOTTER 
*TEXTPARM ALPHABET = 15 


< Enter plotting module > 
*PLOTPROG 
< Define map size > 
*NEWMAP MAPSIZE = 18,24 FRAME 
< Identify polygon file > 
*GIMMSFILE FILE = 11 
< Enter the *MANIPULATE module and compute a new variable > 
*MANIPULATE 
*COMPUTE MANUF2 = (MANUF *2) PRINT 
*END < Leaves the *MANIPULATE module> 
< Return to *PLOTPROG module > 
< Define point, pie, and area shading for 2 levels > 
*SYMBOLISM POINT PIE,SIZE = 2,FIX 
*SYMBOLISM PIE SHADING = 1,2 
*SYMBOLISM AREA SPACING =0.2, SCREEN / SPACING =0.04 
< Draw pie map > 
*MAP VARIABLE = POP,MANUF2, MAPTYPE = POINT 
< Specify two text strings and shield them from being overdrawn > 

*TEXT POSITION = 13.7,14, SIZE =0.4, ‘POPULATION’ 

SHIELD, FRAME, CENTRE ONX 
*TEXT POSITION = 13.7,19.5, SIZE = 0.4, '‘MANUFACTURING' 

SHIELD, FRAME, CENTRE ONX 

< Draw bargraph > 
*BARGRAPH SAMEPAGE VAR =POP,MANUF, ORIGIN = 9.5,13, LENGTH = 8,9 
YMIN =0,YMAX = 200000, YUNITS = 40000,XUNITS = 1 


XLABELS = "WL','SW','SE','EA','WM',' EM',"NW','NE','N','SC' 
SHADEGRP = 1,2, ADDITIVE < ADDITIVE causes bars to be stacked> 


*TEXT POSITION =0.2,0.2,SIZE = 0.3, ALPHABET = 71,TEXT = 'FigureC.4' 
INTERNATIONAL MIGRATION U.K. *END < Leaves the *PLOTPROG module > 


*STOP < Terminates the GIMMS run > 
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COMMAND SEQUENCE USED TO GENERATE FIGURE C.4 
< Set up file assignments > 


*FILEPARM 19,'FIGC4.PLT' ,TEXT,OUT < Plotfile, if required > 


< Set up plotter and defaults > 


C0) *PLOTPARM PLOTTER 
*TEXTPARM ALPHABET = 15 


< Enter plotting module > 


*PLOTPROG 


< Set diagram size > 
*NEWMAP 27 36 FRAME 


< Set out text for line graph and make sure 
that further drawing will not obscure it > 


*TEXT POSITION = 12.3,30.77, SIZE =0.3,'U.K. Emigration’ 
RATIO =0.7, SHIELD 
/ POSITION = 10.78,28.46, ‘Non U.K. Immigration’ 
/ POSITION = 9.23,27.38, 'U.K. Immigration’ 
/ POSITION = 9.23,25.69, 'Non U.K. Emigration’ 


O < Define symbol to be used on graph > 
*SYMBOLISM SYMBOL ALPHABET = 3, CHARACTER = 57, SIZE =0.25 
< Drawline graph at top of page > 


*GRAPH SAMEPAGE ORIGIN =6.5 25.5 LENGTH = 147 
DATA = 
92 108 171 69 111 111 160 73 83 113 176 70 79 105 199 70 
85 112 169 69 87 105 137 73 73 90 144 65 73 114 126 66 
78 117 126 63 67 107 150 79 GROUP4 
< Variables are in GROUPs of 4 > 


XMIN = 1971 XMAX = 1980 XUNITS = 1 
YMIN=50 YMAX =200 YUNITS = 25 TWINY 
XTITLE ='YEAR’ YTITLE ='THOUSANDS' 
LINEGRP =0,0,8 

THICKGRP =0,3,1 

SYMBGRP =0,0,0,1 


< Selects different linetypes 0 = solid > 
< Selects different thicknesses > 

< Selects symbols at data point 

for the 4th variable > 


( ) < Draw bargraph > 
*BARGRAPH SAMEPAGE ORIGIN=2 13 LENGTH =14 7 
DATA = 
171 69 160 73 176 70 199 70 169 69 137 73 
144 65 126 66 126 63 150 79 GROUP 2 
< Data values are in GROUPs of 2 > 


SHADEGRP = 20,3 

XMIN = 1971 XMAX = 1981 XUNITS = 1 
YMIN=50 YMAX = 200 YUNITS = 25 
XTITLE ="YEAR' YTITLE = 'THOUSANDS' 


< Selects shading levels for bars > 


< Draw bottom line graph with shading > 


*GRAPH SAMEPAGE ORIGIN = 10 2 LENGTH = 147 

DATA = 

92 108 111 111 83 113 79 105 85 112 

87 105 73 90 73 114 78 117 67 107 GROUP2 ADDITIVE 

< Data are in GROUPs of 2 and lines will be stacked > 

TWINY,SHADEGRP = 20,3 < Sets shading levels > 
XMIN = 1971 XMAX = 1980 XUNITS = 1 
YMIN =50 YMAX = 300 YUNITS = 25 
XTITLE ='YEAR' YTITLE ='THOUSANDS' 


< Set shading symbolism for level 20 to dense black > 
*SYMBOLISM AREA LEVEL = 20 SPACING =0.016, ANGLE = 270 
< Draw pie chart > 
*PIE X =21,Y =20,R =3 
DATA = 828 1082 1558 697 
SHADING 20 3 20 3 
< Specify text around pie chart > 
*TEXT POSITION = 24.5,22.5, SIZE =0.3 ‘EMIGRATION VERTICAL 
ALPHABET = 64 
/ POSITION = 17.5 ‘IMMIGRATION’ 
*TEXT POSITION = 21,16, SIZE = 0.3 ‘Total (1971-1980)' 
ALPHABET = 16, CENTRE ONX 
< Produce key for graphs > 
*SYMBOLISM POINT SIZE =0.5 FIX SHADE 


*POINT 575 
/ 543 * < Draw two shaded boxes > 


< Set type of symbol > 


*TEXT POSITION = 5,5.5, SIZE =0.3 ‘UK CITIZENS' 
ALPHABET = 16, CENTRE ONX 

*TEXT POSITION = 5,2.5, SIZE =0.3 "NON UK’ 
ALPHABET = 16, CENTRE ONX 


< Specify titles > 


*TEXT POSITION = 13.5,34.5, SIZE =0.75 
"INTERNATIONAL MIGRATION U.K.’ 
ALPHABET = 61, SHADE, CENTRE ONX 

*TEXT POSITION =9,20.5, SIZE =0.6 ‘EMIGRATION’ 
ALPHABET = 61, CENTRE ONX 

*TEXT POSITION = 17,9, SIZE =0.6 IMMIGRATION’ 
ALPHABET = 61, CENTRE ONX 
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COMMAND SEQUENCE USED TO GENERATE FIGURE C.5 
< Set up file assignments > 
*FILEPARM 11,'PEIPOLY.GIMMS' 


/DATA,'PEIDATA.GIMMS' 
/19,'FIGCS.PLT' ,TEXT,OUT 


< Polygon file > 

< Data file > 

< Plotfile, if required > 
< Set up plotter and defaults > 


*PLOTPARM PLOTTER 
*TEXTPARM ALPHABET = 16 


< Enter plotting module > 
*PLOTPROG 
< Set up map frame > 
*NEWMAP 30 20 FRAME 
< Identify the polygon file > 
*GIMMSFILE 11 
< Shift the study area > 

*ORIGIN SHIFT =0,6 

< Set 6 levels and symbolism > 
*LEVELS 6 
*SYMBOLISM SYMBOL 


< Selects a variety of symbols > 


ALPHABET = 3, CHARACTER = 83, SIZE =0.2 
< Size is set for all symbols > 


/ CHARACTER = 84 
/ CHARACTER = 85 
/ CHARACTER = 86 


/ ALPHABET =5, CHARACTER = 80 
/ ALPHABET =3, CHARACTER = 76 PRINT 
*SYMBOLISM AREA < INCLUDE is the percentage of symbols 
to be drawn from the standard grid > 
SPACING =0.3, SYMBOL, INCLUDE 10 
SPACING = 0.3, SYMBOL, INCLUDE 10 
SPACING = 0.3, SYMBOL, INCLUDE 5 
SPACING = 0.3, SYMBOL, INCLUDE 5 
SPACING = 0.3, SYMBOL, INCLUDE 20 
SPACING =0.3, SYMBOL, INCLUDE 5 
LEVEL = 20, SPACING = 0.03, ANGLE = 270 PRINT 
< Level 20 set to solid black > 


“~™~ ™ OM 


< Define horizontal legend with no text values > 


*LEGEND POSITION = 2,3, NOVALUES, SIZE = 2 RIGHT 
< Draw outline of whole study area > 
*DRAWMAP BOUNDARY 
< Select interval types for variable SURFAREA > 
< Note, this is an example map, the data are obviously spurious > 
*INTERVALS VARIABLE = SURFAREA, QUANTILE, FREQ 


< Set all outlines off as basic outline already 
drawn and draw the map > 


*OUTLINE NONE 
*MAP VARIABLE =SURFAREA TYPE =AREA NOLIST 
< NOLIST switches off the text output > 


< Add the legend key text > 


*TEXT SIZE=0.3,KEY=1 ‘Coniferous’ CENTRE ONX 
SIZE=0.3,KEY=2 ‘Deciduous’ CENTRE ONX 
SIZE=0.3,KEY =3 ‘Orchard’ CENTRE ONX 
SIZE =0.3,KEY=4 ‘Marsh’ CENTRE ONX 
SIZE=0.3,KEY=5 ‘Agriculture’ CENTRE ONX 
SIZE=0.3,KEY=6 ‘Open Cast Mining’ 


~~ ~~ 


< Draw main title > 


*TEXT POSITION = 15,18, SIZE = 1, ‘Predominant Land Use Type’ 
ALPHABET = 61, SHADE, CENTRE ONX 


*TEXT POSITION = 15,0.2, SIZE = 0.3, ‘Figure C.5' 
ALPHABET = 15, CENTRE ONX 


*END < Leaves the *PLOTPROG module > 


*STOP < Terminates the GIMMS run > 
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< Draw the bargraph key > 


*LEGEND POSITION =3.0,14.5 SIZE =0.3 BOXSHIFT =0,0.6 NOVALUES 
LEVELS =2 INCLUDE 1,0,1 DRAW 

*TEXT SIZE =0.2 KEY =1,'Total Area of State’/ 
SIZE =0.2 KEY =2,'Total Area of Holdings'/SIZE =0.2 KEY = TOP, 
'(1974 - 75)’ 


< Specify the main title > 
*TEXT POSITION =6.5,17.4 SIZE=0.4 CENTRE ONX RATIO=0.9 
'@62New South Wales - Rural Industries 
@H@16(1965 - 1975)@Z' SHADE UNDERLIN 
< Note that @Z switches off the UNDERLIN mode > 
*TEXT POSITION =0.2,0.2,SIZE =0.3, ALPHABET =71,TEXT ='Figure C.6' 
*END < Leaves the *PLOTPROG module > 


*STOP < Terminates the GIMMS run > 


COMMAND SEQUENCE USED TO GENERATE FIGURE C.6 
< Setup file assignments > 


*FILEPARM 6, "FIGC6.LIS', TEXT 
f. 32; "NSWPOLY.GIMMS',GIMMS,IN 
/ DATA, 'NSWDATA.GIMMS',GIMMS,OUTIN 
/ 19, ‘FIGC6.PLT' ,TEXT,OUT 


< Output listing file > 
< Polygon file > 

< Data file > 

< Plotfile, if required > 


< Set up some global parameters > 


*PLOTPARM PLOTTER 
*TEXTPARM ALPHABET = 16 


< Enter the plotting module > 


*PLOTPROG 
*NEWMAP 13 18 FRAME 


< Set up position and size of study area > 


*GIMMSFILE FILE = 32 
*SCALE FACTOR = 0.0018 
*ORIGIN SHIFT = 1,6.2 


< Draw the study area outline > 
*DRAWMAP OUTLINES = ALL 
< Draw the region codes > 


*TEXT SIZE=0.2 POSITION =2,9.7 'FW'/ 
POSITION = 3.7,9.9 'NW'/ 
POSITION =5.4,10.2 'NT'/ 
POSITION =6.5,10.2 'NC'/ 
POSITION =2.1,8.5 'MY'/ 
POSITION = 3.2,8.2 'MG'/ 
POSITION = 4.2,8.6 'CW'/ 
POSITION =5.5,9.0 ‘HT'/ 
POSITION =4.7,7.7 ‘SE'/ 
POSITION =6.7,8.6 'OS'/ 
POSITION =6.6,8.3 ‘SY'/ 
POSITION =6.3,7.8 ‘IL’ 


< Draw the pointer lines > 
*DRAW 5.7 8.7 6.5 8.7/5.6 8.4 6.4 8.4/5.3 7.9 6.1 7.9 
< Draw the box with the explanatory text > 


*TEXT BOX 8 6.2 11 11.2 FRAME 
"NC-NORTH COAST 
HT-HUNTER 
OS-OUTER SYDNEY 
SY-SYDNEY 
IL-ILLAWARRA 


SE-SOUTH EAST 
CW-CENTRAL WEST 
MG-MURRUMBIDGEE 
FW-FAR WEST 
MY-MURRAY 
NW-NORTH WEST 
NT-NORTHERN' 


< Define shading for levels 1 to 3 > 


*SYMBOLISM AREA 
SPACING =0 / 
SPACING =0.1,ANGLE = 45,PEN = 1 / 
SPACING =0.05,ANGLE = 135,PEN =2 PRINT 


< Blank shading for level 1 > 


< Draw the bottom graph > 


*GRAPH SAMEPAGE ORIGIN =2,1.5 LENGTH =9,3.5 DATA = 
198 395 535 212 243 468 223 546 454 230 328 431 230 542 445 
236 473 467 238 422 416 246 404 480 272 436 840 325 817 782 
325 822 503 GROUP =3 
SHADEGRP =2,0,0 LINEGRP =0,11,1 < Selects shading below bottom 


line and three different line types > 


XMIN = 1965 XMAX = 1975 XUNITS = 1 YMIN = 200 YMAX = 850.01 
YUNITS = 100 XTITLE ='Season' XLABHT =0.2 YLABHT =0.2 


< Draw graph key > 


*DRAW 3.5 4.1 4.75 4.1 

*LINETYPE 11 

*DRAW 3.5 4.5 4.75 4.5 

*LINETYPE 1 

*DRAW 3.5 4.9 4.75 4.9 

*LINETYPE 0 

*TEXT POSITION =5,4 SIZE =0.2 ‘Dairying'/ 
POSITION =5,4.4 'Pastoral'/ 
POSITION =5,4.8 ‘Agricultural’ 





< Draw graph title > 


*TEXT POSITION =6.5,6.0 SIZE =0.4 CENTRE ONX RATIO =0.7 
‘@ZValue of Production of Rural Industries@Z 
@H(000000''s $)' < Note that @Z causes underlining and 
@H causes half height characters > 


< Draw top bargraph > 


*BARGRAPH SAMEPAGE ORIGIN =2,12.5 LENGTH =9,3.5 
VAR = TOTAREA, TOTARHOL GROUP = 2 
YMIN =0 YMAX = 20000.1 YUNITS = 2000 XUNITS =1 
XTITLE = ‘State’ YTITLE ='000''s Hectares’ XLABHT =0.2 YLABHT =0.2 
XLABELS ='SE','IL','SY','OS','HT',"NC',’NT',, NW','MY','FW', 
‘MG','CW' 
SHADEGRP = 1,3 
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Figure C.7 


< Specify main and subsidiary titles > 


*TEXT POSITION = 6.5,17.3 SIZE =0.5 CENTRE ONX RATIO =0.9 
‘Classification of Rural Holdings 


@HNew South wales - 1975' < @H switches to half size text > 


/ POSITION = 7.4,4.5 SIZE =0.2 CENTRE ONX RATIO =0.8 FRAME 
‘Holdings Growing 
Fruit and Vegatables' 
/ POSITION =7.5,9.7 FRAME 
‘Holdings Keeping Sheep 
and Growing Cereal’ 
/ POSITION =7.5,14.9 FRAME 


‘Holdings Keeping 
Cattle’ 


*TEXT POSITION =0.2,0.2,SIZE = 0.3, ALPHABET = 71,TEXT ='FigureC.7' 
*END < Leaves the *PLOTPROG module > 


*STOP < Terminates the GIMMS run > 


COMMAND SEQUENCE USED TO GENERATE FIGURE C.7 
< Set up file assignments > 


*FILEPARM 6, ‘FIGC7.LIS',TEXT,OUT 
/ 32, ‘'NSWPOLY.GIMMS',GIMMS,IN 
/ DATA, ‘NSWDATA.GIMMS',GIMMS,OUTIN 
/ 19, ‘FIGC7.PLT',TEXT,OUT 


< Output listing file> 

< Polygon file > 

< Data file > 

< Plotfile, if required > 
< Set up plotter and defaults > 


*PLOTPARM PLOTTER 
*TEXTPARM ALPHABET = 16 


< Enter plotting module > 
*PLOTPROG 
< Define size and shape of map > 
*NEWMAP 13,18 FRAME 
< Specify and shield text string > 


*TEXT POSITION = 11,16 SIZE =0.2 ‘Inset’ 
SHIELD CENTRE ONX 


< Identify polygon file, scale and position the study area > 
*GIMMSFILE FILE = 32 
*SCALE FACTOR =0.0018 
*ORIGIN SHIFT =0,1 


< Define symbol type (palm tree) and set 
point symbolism to use it > 


*SYMBOLISM SYMBOL ALPHABET =3 CHARACTER = 82 PEN =3 
*SYMBOLISM POINT SCALED SYMBOL SIZE =2 


< Set size and position of legend > 

*LEGEND POSITION =6,1.5 SIZE =0.3 BOXSHIFT =0,0.3 

< Note that BOXSHIFT identifies the distance 

between the legend elements > 
< Draw the bottom map > 
*MAP VAR =FRUVEG TYPE = POINT 
< Define the window for the bottom right inset > 

*WINDOW 9.5,1 12.5,6 FRAME 


< Set the scaling and origin for the window > 


*SCALE FACTOR = 0.007 


*ORIGIN PLOT = 11,3.5 MAP = 2500,1250 


< Switch the legend off and redraw the map which 
will be clipped at the window boundaries > 


*LEGEND OFF 
*MAP VAR =FRUVEG TYPE = POINT 


< Now reset and repeat procedure for middle map and inset > 
*WINDOW OFF < Set window off for main map> 


*SYMBOLISM SYMBOL ALPHABET = 4, CHARACTER = 89 
*SYMBOLISM POINT SCALED SYMBOL SIZE =1 


< Select symbol > 


*SCALE FACTOR =0.0018 
*ORIGIN SHIFT =0,6.2 


< Rescale and origin for main map > 


*LEGEND ON POSITION = 6,6.7 
*MAP VAR = SHEEPCER TYPE = POINT 


< Define inset > 


*WINDOW 9.5 6.2 12.5 11.2 FRAME 
*SCALE FACTOR = 0.007 

*ORIGIN PLOT 11,8.7 MAP = 2500,1250 
*LEGEND OFF 

*MAP VAR =SHEEPCER TYPE = POINT 


< Reset and repeat for top map and inset > 
*WINDOW OFF 


*SYMBOLISM SYMBOL ALPHABET = 5, CHARACTER = 80 PEN =2 
*SYMBOLISM POINT SCALED SYMBOL SIZE =1.5 


*SCALE FACTOR = 0.0018 

*ORIGIN SHIFT =0,11.4 

*LEGEND ON POSITION = 6,11.9 
*MAP VAR =MEAMIL TYPE = POINT 


< Define inset > 

*WINDOW 9.5 11.4 12.5 16.4 FRAME 
*SCALE FACTOR =0.007 
*ORIGIN PLOT 11,13.9 MAP = 2500,1250 
* LEGEND OFF 
*MAP VAR =MEAMIL TYPE = POINT 
*WINDOW OFF < Switch off window > 
*PEN 4 < Select different colour > 

< Draw boxes on main maps to show extent of insets > 


*BOX 42.654/47.859.2/413.05 14.4 
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COMMAND SEQUENCE USED TO GENERATE FIGURE C.8 
< Set up file assignments > 


*FILEPARM 6, ‘FIGC8.LIS',TEXT,OUT 
/ 32, ‘'NSWPOLY.GIMMS',GIMMS,IN 
/ DATA, 'NSWDATA.GIMMS',GIMMS,OUTIN 
/ 19, ‘FIGC8.PLT',TEXT,OUT 


< Output listing file > 

< Polygon file > 

< Data file > 

< Plotfile, if required > 
< Set up plotter and defaults > 


*PLOTPARM PLOTTER 
*TEXTPARM ALPHABET = 16 


< Enter plotting module > 
*PLOTPROG 
< Define size and shape of map > 
*NEWMAP 18,13 FRAME 
< Set up shading patterns for 4 levels > 
*SYMBOLISM AREA 
SPACING = 0.05, ANGLE = 45, PEN =2 
/ SPACING =0.05, ANGLE = 45, PEN =2 
& SPACING = 0.05, ANGLE = 135, PEN =2 
/ SPACING =0.05, ANGLE = 45, PEN =3 
/ SPACING =0.05, ANGLE = 45, PEN =3 
& SPACING = 0.05, ANGLE = 135, PEN = 3 PRINT 
< Identify polygon file, scale and position the study area > 
*GIMMSFILE FILE = 32 
*SCALE FACTOR =0.003 
*ORIGIN SHIFT =0,4 
< Enter the *MANIPULATE module and compute a new variable > 
*MANIPULATE 
*COMPUTE TOTAL ABS = (SHEEPCER + MEAMIL + FRUVEG + POLPIG) 
*END < Leaves the *MANIPULATE module> 
< Set point and pie symbolism > 


*SYMBOLISM POINT SCALED PIE SIZE =2 
*SYMBOLISM PIE SHADING = 1,2,3,4 SHADE 


< Draw main map > 
*MAP VARIABLE = TOTAL,SHEEPCER,MEAMIL,FRUVEG,POLPIG TYPE = POINT 
< Draw left hand bargraph > 


*BARGRAPH SAMEPAGE VAR =SHEEPCER,MEAMIL,FRUVEG,POLPIG 


GROUP = 4 SCALED 
< SCALED causes the bars to expand to the full height > 


SHADEGRP = 1,2,3,4 ORIGIN = 2,1 LENGTH =6.5,3 XUNITS = 1 YUNITS = 20 
XLABHT =0.2,XLABELS ='SE',‘IL','SY','OS','HT','NC','NT’,'NW','MY' 
"FW','MG','CW' 
YMIN =O YMAX = 100.01 YTITLE = ‘Percent’ 
< YMAX = 100.01 ensures that the 100 tick is shown 
it sometimes stops short due to rounding error > 


< Draw right hand bargraph which is a normal ADDITIVE 
stacked bar graph > 


*BARGRAPH SAMEPAGE VAR = SHEEPCER,MEAMIL,FRUVEG,POLPIG 
GROUP = 4 ADDITIVE 
SHADEGRP = 1,2,3,4 ORIGIN = 10.5,1 LENGTH =6.5,3 XUNITS = 1 
XLABHT =0.2,XLABELS ='SE','IL’,’SY','OS',,/HT','NC','NT',,NW','MY’ 
"FW','MG','CW' 
YUNITS = 2000 YMAX = 8000.1 YTITLE ='No. of Holdings’ 
< Specify shielded text > 
*TEXT SIZE =0.2 
POSITION = 10.3,8.5 SHIELD ‘Poultry and Pigs' FRAME/ 
POSITION = 10,6.5 SHIELD ‘Fruit and Vegetables’ FRAME/ 


< Note that the SIZE parameter is carried forward > 


POSITION = 14. 
5 


8.5 SHIELD ‘Sheep and Cereals’ FRAME/ 
POSITION = 1 5S 


5 
6.5 SHIELD ‘Cattle’ FRAME/ 
< Specify the main title > 


POSITION = 14,11.5 SIZE =0.45 CENTRE ONX ‘New South Wales 
@HRural Holdings - 1975' FRAME 


< Draw the legend pie > 
*PIE POSITION = 14,7.5 SIZE =2 DATA =1,1,1,1 SHADING = 1,2,3,4 
*TEXT POSITION = 0.15,0.15,SIZE =0.25,ALPHABET = 71,TEXT = ‘Figure C.8' 
*END < Leaves the *PLOTPROG module > 


*STOP < Terminates the GIMMS run > 


*DRAW 0 4.25 18 4.25 


= 0.2, ALPHABET =71,TEXT ='FigureC.9' 


*TEXT POSITION =0.2,0.2,SIZE 


*PLOTPROG module > 


< Leaves the 


*END 


< Terminates the GIMMS run > 


*STOP 
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COMMAND SEQUENCE USED TO GENERATE FIGURE C.9 
< Setup file assignments > 


*FILEPARM 6, 'FIGC9.LIS',TEXT 
/ 32, 'NSWPOLY.GIMMS' 
/ DATA, 'NSWDATA.GIMMS' 
/ 19, ‘FIGC9.PLT',TEXT,OUT 


< Output listing file > 
< Polygon file > 

< Data file > 

< Plotfile, if required > 


< Set up plotter and defaults > 


*PLOTPARM PLOTTER 
*TEXTPARM ALPHABET = 16 


< Enter plotting module > 
*PLOTPROG 
< Define size and shape of map > 
*NEWMAP 18,13 FRAME 
< Define shading patterns for 5 levels > 


*SYMBOLISM AREA 
SPACING =0.1, SCREEN, PEN = 2/ 
SPACING =0.1, ANGLE = 45, PEN = 1/ 
SPACING =0.1, ANGLE = 45, PEN = 1 
& SPACING =0.1, ANGLE = 135, PEN = 2/ 
SPACING =0.05, ANGLE = 45, PEN = 1 
& SPACING = 0.05, ANGLE = 135, PEN =2/ 
SPACING = 0.05, ANGLE = 45, PEN =2 
& SPACING =0.05, ANGLE = 135, PEN =2 PRINT 


< Identify study area, scale and position the study area > 
*GIMMSFILE FILE = 32 
*SCALE FACTOR = 0.003 
*ORIGIN SHIFT =0,4 
< Set the intervals for the shaded map variable. The 

dot map variables do not require this since the 

value of the variable defines the number of dots > 
*INTERVALS VAR =TOTCATT USER =0,100,200,750,1000,2000 FREQ 

< Define the legend and draw the legend title > 


*LEGEND POSITION =7.5,4.5 SIZE =0.4 BOXSHIFT =0.4,0.4 LEVELS =5 
< the BOXSHIFT values causes the stepping effect > 


*TEXT POSITION =9 KEY =TOP,'Total Cattle (000''s)' 
< Draw the main map using area shading > 


*MAP VAR =TOTCATT TYPE = AREA 


< Set up of three dot maps > 
< First set the dot colour > 
*SYMBOLISM DOT COLOUR = 2 
< Reset the scale and switch the legend off > 


*SCALE FACTOR =0.0014 
* LEGEND OFF 


< Position the study area and draw the dot map > 


*ORIGIN SHIFT =0.5,0.25 
*MAP VAR = BULLS TYPE = DOT 


< and again for the second map > 


*ORIGIN SHIFT =6,0 
*MAP VAR = CREAM TYPE = DOT 


< and again for the third map > 


*ORIGIN SHIFT =6,0 
*MAP VAR = MEATY TYPE = DOT 


< Specify the main title with FRAME > 


*TEXT POSITION = 14,11.5 SIZE =0.45 CENTRE ONX 'New South Wales 
@HCattle - 1975' FRAME 


< Specify the dot map titles > 


*TEXT SIZE=0.2 CENTRE ONX POSITION = 3,0.2 ‘Bulls'/ 
POSITION =9,0.2 ‘Cattle (Dairy Production)'/ 
POSITION = 15,0.2 ‘Cattle (Meat Production)' 


< Draw the upper frequency histogram bar graph > 


*BARGRAPH SAMEPAGE ORIGIN = 10,8 LENGTH =7,2 VAR = TOTCATT FREQ = 10 
< FREQ = 10 defines that 10 frequency bars should be used> 


SHADE NOXTICS NOXSTICS NOXLAB NOYAXIS 
BARTEXT TOP XTITLE = ‘Frequency Histogram’ 
< the BARTEXT TOP option causes the number of occurrences 
to be printed at the top of each bar > 


< Draw the class histogram > 
*BARGRAPH SAMEPAGE ORIGIN = 14,4.9 LENGTH = 3,2 VAR = TOTCATT 
SHADE FREQ CLASSES < Causes a class histogram > 
NOXLAB NOXTICS NOXSTICS NOYAXIS 
BARTEXT TOP XTITLE = ‘Class Histogram’ 


< Draw the horizontal line > 
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COMMAND SEQUENCE USED TO GENERATE FIGURE C.10 


< Set up file assignments > 


*FILEPARM 6, 'FIGC10.LIS', TEXT,OUT < Output listing file > 
/ 32, 'NSWPOLY.GIMMS',GIMMS,IN < Polygon file > 
/ GRID, 'NSWGRID.GIMMS',GIMMS,OUTIN < Grid file > 


/ 19, ‘FIGC10.PLT',TEXT,OUT < Plotfile, if required > 
< Set up plotter and defaults > 


*PLOTPARM PLOTTER 
*TEXTPARM ALPHABET = 16 


< Enter plotting module > 
*PLOTPROG 
< Define size and shape of map > 
*NEWMAP 18,13 FRAME 
< Identify polygon file and set scaling information > 


*GIMMSFILE 32 
*SCALE FACTOR =0.004 


< Draw the outlines of study area > 
*DRAWMAP OUTLINES = ALL 


< Inform the system that the GRID file is to be used 
from now on and set the scaling > 


*GIMMSFILE GRID 
*SCALE FACTOR =0.004 


< Set shading for 5 levels > 


*SYMBOLISM AREA 
SPACING = 0.1 SCREEN PEN = 3/ 
SPACING = 0.1 ANGLE = 45 PEN = 1/ 
SPACING = 0.1 ANGLE = 45 PEN = 1 & SPACING = 0.1 ANGLE = 135 PEN = 3/ 
SPACING = 0.05 ANGLE = 45 PEN = 1 & SPACING =0.05 ANGLE = 135 PEN = 3/ 
SPACING = 0.05 ANGLE = 45 PEN =3 & SPACING = 0.05 ANGLE = 135 PEN = 3 
PRINT 


< Setall contours to be shaded and splined > 
*SYMBOLISM CONTOUR SHADE SPLINE 
< Set the interval values for variable NEWBULLS > 
*INTERVALS GRID VAR = NEWBULLS USER =0,5,10,15,20,40 FREQ 


<GRID instructs the system to look for 
NEWBULLS on the GRID file> 


< Set the legend size and position and put title > 


*LEGEND POSITION = 14,9 SIZE =0.4 
*TEXT KEY = TOP, Bulls (000''s)’ 


< Map the distribution using contours > 
*MAP VAR = NEWBULLS TYPE = CONTOUR 
< Draw the shaded line graph > 


*GRAPH SAMEPAGE ORIGIN = 12.5,1.5 LENGTH =4,2 GROUP =2 DATA= 
102359 13275 115035 12031 128973 11717 
135696 11181 142218 10424 151816 11037 
XUNITS = 1 XMIN = 1970 XMAX = 1975 YMAX = 160000 YUNITS = 80000 
XLABHT =0.2 YLABHT =0.2 PENGRP = 3,1 SHADEGRP =3,4 
XLABELS ='1970','71','72','73','74','1975' 
< Thetext is automatically placed atendof graph lines > 
*TEXT SIZE =0.15 KEY =1,'Dairy 
Breeds’ 
/SIZE =0.15 KEY =2,'Beef 
Breeds’ 
< Plot the titles > 

*TEXT POSITION =9,12 SIZE =0.6 CENTRE ONX SHADE 

'@74 NEW SOUTH WALES' 
*TEXT POSITION = 14.5,4 SIZE =0.2 CENTRE ONX UNDERLIN 

"Bulls (1970 - 1975)’ 


*TEXT POSITION =0.2,0.2,SIZE =0.3, ALPHABET =71 
TEXT = ‘Figure C.10' 


*END < Leaves the *PLOTPROG module> 


*STOP < Terminates the GIMMS run > 


APPENDIX D 
SPECIFYING NEW ALPHABETS 


Up to 99 character sets may be specified, each of up to 127 characters. A specific 
character is chosen by the user by specifying @nnc where nn is the two digit alphabet 
number and c is a string of the ASCII base characters. Note that various systems (e.g. 
GIMMS) allow the selection of the alphabet to be used outside the string, but it may 
always be overridden inside the string itself. For example: 


*TEXT ---, ALPHABET = 17,TEXT = 'ABCD@25EFGH' 


would draw the base characters ABCD in alphabet 17 and the base characters EFGH in 
alphabet number 25. It should be noted that IT DOES NOT FOLLOW that the actual 
characters A-H will be drawn. The base character A in alphabet 25 may correspond to 
(e.g.) an integral sign. 


DESCRIPTION OF ALPHABETS 


Each alphabet to be input contains an alphabet start line (‘A’ in column 1) followed by 
a set of character descriptions. Each character description contains a character start 
line (‘C' in column 1) followed by a list of coordinates. An alphabet is terminated by an 
end line (‘'E' in column 1). A set of alphabets is terminated by a finish line (F’ in 
column 1). Thus the definition of aset of alphabets has the form: 


Column 1 
Ac ee 
C ee 


mM 


mM 


ALPHABET START LINE 
This line contains information ina fixed format. 
Column(s) 


1 A 
3-5 13, alphabet number, value 1-99 
6-10 F5.2, ratio value to multiply X,Y coordinates to get range 0-6 
11-15 15, value to add to digitised X values (i.e. X origin shift) 
16-20 15, value to add to digitised Y values (i.e. Y origin shift) 
21-25 15, value to multiply digitised X values by (zero value taken as 1) (n.b. -1 
inverts X) 


I5, value to multiply digitised Y values by (zero value taken as 1) (n.b. -1 
inverts Y) 

I5,1f 1 then addition to an alphabet 

unassigned 

character 1 (one) unless old format alphabet 

unassigned 

29A1, description (not stored) 


This line either initialises an alphabet or prepares for additions to an existing one. 


CHARACTER START LINE 


Column(s) 
1 #C¢ 

3-5 13, ASCII value of character 1-127 

6-10 15, alphabet value of indirect character, 1-99 
11-15 5, ASCII value of indirect character, 1-127 
16-20 15,number of characters following to be assigned to indirect alphabet 
21-25 unassigned 
26-30 unassigned 
31-35 15, Hershey character value, if appropriate (not stored) 
36-40 unassigned 
41-69 29A1, description (not stored) 


This line initialises a character of the currently selected alphabet. It can be specified in 
two ways. If columns 6-20 are left blank then coordinates of the character are 
expected to follow. If these columns are specified than a pointer is set up to the 
specified character in the specified alphabet. By using columns 16-20 whole blocks of 
an alphabet can be pointed to blocks of another alphabet. 


Any character not defined will use the default character set. 


CHARACTER DESCRIPTION 


A character description consists of a set of coordinates which are entered up to 7 per 
line. The format is fixed. 


Column(s) 
1 blank 
2-11 coordinate, see description below 
12-21 ; " " : 
22-31 . . " ‘ 
32 - 41 . ‘ é ‘ 
42-51 " . z . 
52 - 61 7 " 7 : 
62-71 : . 7 " 


A code of 9000000000 indicates the end of the character description and MUST be 
present. 


It should be assumed that the pen is positioned at the bottom left of the character 
position with the pen lowered and the pen should have been positioned to the lower 
right of the character space with the pen either raised or lowered. 


COORDINATE DESCRIPTION 
Column(s) (with the coordinate) 


blank (or 0) no action 

1 end of astraight line 

9 end of character description 
blank (or 0) pen down 

1 pen up to this point 


1 Special codes 


2 Pencode 


hou Ww ue ul 


3 Signof X blank (or 0) positive 
1 negative 
4-6 Xcoordinate (0-999) 

7 ~~ Sign of Y (as X) 


8-10 Y coordinate (as X) 


ALPHABET END LINE 
This line ends an alphabet description. It isin fixed format. 


Column 
1 E 


When this line is entered, an end of alphabet is recognised. The next line should be an 
alphabet start line to indicate that more alphabets are to follow or the alphabet finish 
line to indicate end of all alphabets. 


ALPHABET FINISH LINE 
This line ends alphabet descriptions. It isin fixed format. 


Column(s) 
1 F 
3-5 13, =0 donotstore this asaset of permanent alphabets 
>0 store these alphabets permanently 


This line indicates that the input of alphabets is to terminate. The alphabets may be 
accessed using the normal text mechanisms provided by the appropriate software. If 
the value in columns 3-5 is set to greater than zero then the alphabets described are 
made permanent and will not be able to be altered. In fact, any alphabet with a 
number less than the largest of the permanent alphabets will be protected as well. 
Thus if alphabet 95 is made permanent, none of the alphabets 1-95 can be altered and 
only 96-99 may be utilised for temporary alphabets. 


SIMPLE EXAMPLE 


Figure D.1 shows a simple example of creating two alphabets, each with only one 
letter. 


(DEFAULT CHARACTER SET) 
(LETTER A) 
51 1 61 51 4 O11 Q 31 4 3 
6 09000000000 


720.667 1 (HERSHEY, ROMAN, CARTOGRAPHIC) 


65 1 (LETTER A) 
11 5 91 5 «(91 9 111 3 #31 #+#F 311 10 Q 
9000000000 





FIGURE D.1 
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*POLYGON, 5-2, 3-18, 5-0 
*REDRAW, 6-108 
*RESTORE, 9-26, 3-19, 6-108 
*ROTATE, 6-7 
*SAVE, 9-26, 3-19 
*SCALE, 6-7 

*SCATTER, 6-89, 7-1, 7-8, 7-42 
*SCISSOR, 6-89, 6-91 
*SETLINES, 6-101 
*SHIELD, 6-89, 6-93 
*SMOOTH, 8-27 

*STOP, 3-18, 3-1, 3-2 
*STORE, 6-108 

*SUBSET, 8-23 
*SYMBOLISM, 6-56 
AREA, 6-56 

CONTOUR, 6-83 

DOT, 6-76 
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LABEL, 6-75 

PIE, 6-80 

POINT, 6-67 

SYMBOL, 6-78 
*SYSPARM, 3-3 
*TERMINAL, 9-26 
*TEXT, 6-26, 3-21, 6-107 
ALPHABET, 6-30 
POSITION, 6-28 

SIZE, 6-28 
*TEXTPARM, 3-15 
*UTILITIES, 9-0, 3-2, 3-18, 5-1 
List of commands, 9-1 
*VARIABLE, 6-18, 6-24 
*WINDOW, 6-89, 6-91 
*ZOOM, 6-109 


ABSOLUTE, 4-28, 8-12, 8-14 
ACCENTS, A-2 
Aggregation of data, 8-2 
Alias, 2-5 
ALPHA, 8-14 
ALPHABET, 3-15 
ALPHABETS, B-1 
Specifying new alphabets, 9-2, D-1 
Angle searching, 8-16 
Appendices 
A Specifying text strings, A-1 
B GIMMS alphabets, B-1 
C Examples of GIMMS commands, C-1 
D Specifying new alphabets, D-1 
APPLICATION MODULES, 2-2, 3-18 
Area (polygon) and Segment data input, 4-6 
Area (polygon) data, 4-3 
Arrows, 6-99 
AUTONODE, 4-12, 4-25 


Background colour, 3-13 
Bar graphs, 7-1 
BARGRAPH, 6-89 

Boxes and frames, 6-89 


Calling macros, 9-34 

Centre of gravity, 5-1 
CENTROIDS, 4-18, 4-22 
CHARACTER POSITION, A-5 
CHARACTER SET, A-3 
CHARACTER SHAPE, A-5 
CHARACTER SIZE, A-4 

Class intervals, 6-48 
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Frequency histograms, 6-53, 6-54 
Selecting number of levels, 6-48 
Specifying break points, 6-48 
Types, 6-50 
User defined, 6-53 
Collapsed Segments, 5-20 
Colour selection, 6-101 
Graphs and bar graphs, 7-34 
Grids on graphs, 7-49 
Pies, 7-56 
Command Documentation, 2-10 
Command input, 2-1, 2-4, 3-1 
Command mode, 3-6 
Commands, 3-6 
Conversational, 3-6 
Menu, 3-6 
Verbosity, 3-6 
Commands, 2-4 
Comments, 2-8 
Common boundaries, 4-5 
Compilation of maps, 6-105 
Compile, 6-105 
Deleting objects, 6-108 
Restoring a session, 6-108 
Saving a session, 6-108 
Storing results, 6-107 
Zooming on screen, 6-109 
Compound Errors, 5-21 
Compute a new variable, 8-7 
Arithmetic operators, 8-9 
Constants, 8-9 
DATAFILE or GRIDFILE, 8-8 
Examples, 8-12 
Expressions, 8-8 
Functions, 8-9 
Logical conditions (IF, THEN, ELSE), 8-10 
Logical operators, 8-10 
Variable name, 8-8 
Variable types, 8-12 
Continuous symbolism, 6-23 
Contour mapping, 6-23, 6-24, 6-83 
Contour symbolism, 6-83 
Conversational Mode, 3-6 
CONVERT, 4-20 
Converting data on to a grid, 8-13 
Examples, 8-15 
Method, 8-14 
Variable types, 8-14 
CONVGRID, 6-25 
Coordinate Input, 4-6 
Coordinate transformation, 4-20 
Create DATA and GRID files, 9-4 
Cursor Operations, 2-14 
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DATA INPUT AND DATA OUTPUT, 2-1 
Data transfer, 9-9 
DATAFILE, 3-7, 3-9, 3-20, 4-8, 6-8, 8-8, 8-25, 9-10 
Automatically created variables, 9-6 
Creation, 9-4 
Example of creation, 9-4 
Saving and restoring, 9-26 
Default Values, 2-12 
Deleting variables, 8-15 
DENSITY, 4-28, 8-12, 8-14 
Diagnostic level, 3-4 
DIAGS, 2-8, 3-3, 3-4, 4-19 
Digitiser coordinates, 4-20 
Digitising, 4-23 
Direction of digitising, 4-24 
Important parameters, 4-23 
Interpreting the output, 4-24 
Labelling of segments, 4-24 
Point mode, 4-24 
Preparation of base maps, 4-23 
Short segments, 4-24 
Stream mode, 4-23 
Direction of digitising, 4-6 
Distance searching, 8-16 
Documentation description, 2-10 
Dot symbols, 6-95 
Douglas/Peucker, 4-12, 5-5, 5-9 


Editing Procedures, 5-28 
Editing Process, 5-22 
Error 
AGGREGATE/ISORT VALUE OUTSIDE RANGE, 8-3 
BOUNDARY NOT CLOSED, 5-17 
CENTROID NOT MATCHED, 4-19 
END OF INPUT, 3-18 
ERROR IN AREA DESCRIPTION, 5-17, 5-27 
GAP, 5-5, 5-13, 5-17 
ILLEGAL SYMBOLIN DATA, 4-30 
IN TOLERANCE, 5-5 
LAST POINT DOES NOT CLOSE ISLAND, 5-14, 5-18, 5-19, 5-20 
MAXPTS IGNORED, 5-5 
MINIMUM IS LOWER THAN OR EQUAL TO ZERO, 6-51 
NAME OUT OF RANGE, 5-1, 5-4 
NO DATA SPACE LEFT, 5-1 
NO VALUE TO MATCH KEY GIVEN, 2-7 
NODE NOT MATCHED WITHIN TOLERANCE, 5-27 
NOT AN EVEN NUMBER OF INTERVALS, 6-51 
NOT ENOUGH SPACE, 3-5 
NOT ENOUGH WORK SPACE, 6-51 
ONLY SEGMENT, 5-18 
OUT OF AREA, 6-37 
OVERFLOW ON LINKS, 3-5 
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SEGMENT CHOSEN HAS ONLY ONE POLYGON SELECTED, 5-26 
SIZE OF POLYGON TOO LARGE, 5-1, 5-5 
TOO FEW CLASSES, 6-51 
TOO MANY CLASSES, 6-51 
TOO MANY NAMES FOR DATA SPACE, 5-1, 5-4 
TOO MANY NODES, 5-30 
TOO MANY POLYGONS SELECTED, 5-30 
TOO MANY SEGMENTS, 5-30 
TYPE n, 6-51 
VARIABLE NAME NOT RECOGNISED, 8-9 
ZONE ... HAS TOO MANY SEGMENTS, 3-5, 5-2 
ZONES WITH ERRORS, 5-17 
Examples, C-1 
General, 3-1 
EXCLUDE ZONES, 5-6 
Expression value, 2-12 


File dumping, 9-9 
Examples, 9-13 
Format of output, 9-14 
File transfer, 9-9 
FILENAME, 3-8 
Files 
Access modes, 3-8 
Examples of specification, 3-10 
Internal information, 3-19 
Name, 3-8 
Specifying channels, 3-7 
Type, 3-8 
Fixed Format Data Input, 4-30 
FORTRAN, 4-28, 4-30, 8-10, 9-13 
Free Format Data Input, 4-29 


General Parameter Input System, 2-5 
Generalisation, 3-11, 4-3, 4-12, 5-5, 5-9, 6-9, 9-20 
Geographic searching, 8-16 

Angle, 8-21 

Distance, 8-18 

Inside, 8-21 

Multiple searches, 8-22 

Overlap, 8-21 

Types of searching, 8-18 

Using CENTROID to reduce processing, 8-22 
GIMMS logo, 3-3, 3-12, 3-15 
GIMMS Macro Guide, 9-34 
GIMMS project, 2-2 
GPIS, 2-5 

/ terminator, 2-8 

Aliases, 2-5 

Characteristics, 2-10 

Cursor operations, 2-14 
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Default values, 2-12 
Documentation, 2-10 
Graphic cursor actions, 2-12 
Help, 2-9 
Implicit pointer, 2-6 
Order, 2-5 
Parameter list, 2-6 
Pointer, 2-6 
Separators, 2-5 
Special actions, 2-14 
Terminators, 2-7 
Types, 2-11 
Values, 2-5 
Graphic Cursor Actions, 2-12 
Graphic devices 
Selection, 3-11 
Graphics 
Axes definition, 7-21 
Axes size and position, 7-18 
colour selection, 7-34 
Data values, 7-16 
Drawing grids, 7-47 
Examples, 7-1 
Exchanging axes, 7-51 
Frequency histograms, 7-44 
Highlighting parts of lines, 7-36 
Horizontal bar graphs, 7-51 
Indenting and offsetting graphs, 7-51 
Labelling axes, 7-30 
Line symbolism, 7-33 
List of commands, 7-8 
Multiple bars, 7-40 
Multiple graphs ona page, 7-16 
Multiple lines, 7-38 
Overlaying data variables, 7-47 
Page size, 7-16 
pen selection, 7-34 
Plotting values on bar graphs, 7-49 
Providing key information, 7-33 
Scattergrams, 7-42 
Setting margins for graphs, 7-20 
Suppressing parts of axes, 7-30 
Titles, 7-31 
Twin Y axes, 7-27 
GRIDFILE, 3-7, 3-9, 3-20, 6-8, 6-50, 8-8, 8-25, 9-10 
Automatically created variables, 9-6 
Creation, 9-4 
Example of creation, 9-7 
Saving and restoring, 9-26 
Grids, 6-89 
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Hash System, 4-26 

Help, 2-9 

Hershey, B-1 

Hierarchial labelling, 4-14 
Hierarchial polygon selection, 4-15 


INCHES, 3-12 
INCLUDE ZONES, 5-6 
Input 
Command mode, 3-6 
Default channels, 3-1 
Fixed format, 2-2 
Free format, 2-2 
General, 2-2 
Limitations - columns 1 to 80, 2-2 
Modules and command names, 2-4 
Other input, 2-4 
Parameters or options, 2-4 
Redirection, 3-4 
Sub - commands, 2-4 
Integer number, 2-11 
INTERP, 6-25 
Interpolation on GRID files, 8-28 
Examples, 8-31 
Limiting to study area, 8-29 
Method, 8-30 
Selecting extent of interpolation, 8-30 
Valid cells, 8-30 
INTRODUCTION, 1-0 
Command Structure, 1-1 
Data input, 1-1 
Design facilities, 1-1 
General, 1-1 
Graphs and charts, 1-1 
Interfaces to other packages, 1-2 
Operational modes, 1-1 
Statistical maps, 1-1 
Text manipulation facilities, 1-1 
ISLANDIHOLE, 5-14 
Ilsopleth mapping, 6-24, 6-83 


Keyword value, 2-11 


Label value, 2-11 

Legend, 6-38 
Direction, 6-41 
Dot symbols, 6-95 
Format, 6-44 
Positioning, 6-39 
Sizing, 6-39 
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Suppression, 6-43 
Suppression of text, 6-43 
Title, 6-46 
Types, 6-44 

Line data input, 4-7 

Line drawing, 6-93 

Line graphs, 7-1 

Line type, 6-101 
For graphs, 7-33 
Selection, 6-101 
Specification, 6-101 

Line types 
Pies, 7-56 

LINES, 4-18, 4-22 

Locational data, 2-1, 4-11 
Area and Segment data input, 4-6 
Areas (polygons), 4-3 
Coordinate input, 4-6 
Data entry, 4-14 
From data variables, 4-26 
General example, 4-1 
Input, 4-1 
Lines, 4-6 
List of options, 4-9 
Point input, 4-7 
Points, 4-6 
Terminator, 4-21 


MACROFILE, 3-7 

Macros, 9-29 
Calling macros, 9-34 
Creation, 9-29 
GIMMS macro guide, 9-34 
Macro specification, 9-33 
Name, 9-30 
Selection of default library, 3-5 
Specification, 9-29 
Specification of parameters, 9-31 
Specifying a library, 3-10 

Main control program, 3-1 
List of commands, 3-2 

Map types, 6-20 

MAPSIZE, 6-7 

Margins, 7-20 

MENU, 3-6 

Menu Mode, 3-6 

MERGE, 9-7 

Merging GIMMS files, 9-19 
Changing names of zones, 9-20 
Examples, 9-21 
Input files, 9-19 
Selective inclusion of zones, 9-20 
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Mislabelling Segments, 5-18 
Missing Segments, 5-17 
Modifying centroids, 9-21 
Examples, 9-24 
From a hard copy map, 9-23 
Interactively, 9-23 
Multi-component Maps, 6-24 


Node tolerance, 4-20 
NODES, 4-12, 4-18, 4-22 
NOMINAL, 8-14 
Non-locational data, 2-1, 4-27 
Creating space for variables, 4-29 
Data entry, 4-29 
Examples, 4-30 
Fixed format input, 4-28, 4-30 
Free format input, 4-29 
General example, 4-7 
Input, 4-7 
List of options, 4-9 
Naming variables, 4-27 
Preparation of data, 4-30 
Types, 4-28 
North arrows, 6-97 


On-screen menus, 3-6 
Options, 2-4 
Ordnance Survey DMC map data, 4-13 
Ordnance Survey National Grid, 4-20 
OUTIN, 3-7 
OUTLINES, 6-8 
Outlines of study area, 6-104 
Output 
Default channels, 3-1 
Diagnostic level, 3-4 
Graphic, 2-1 
Printed, 2-1 
Redirection, 3-4 
Overshooting!/! Concatenation of Segments, 5-19 


Parameters, 2-4 
/ terminator, 2-8 
Aliases, 2-5 
Characteristics, 2-10 
Cursor operations, 2-14 
Default values, 2-12 
Documentation, 2-10 
Graphic cursor actions, 2-12 
Help, 2-9 
Implicit pointer, 2-6 
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List, 2-6 
Order, 2-5 
Pointer, 2-6 
Separators, 2-5 
Special actions, 2-14 
Terminators, 2-7 
Types, 2-6, 2-117 
Values, 2-5 
Path searching, 8-16 
Pen selection, 6-100 
Graphs and bar graphs, 7-34 
Grids on graphs, 7-49 
Pies, 7-56 
Pie charts, 7-1, 7-51 
Exploded pies, 7-57 
Line type and penlcolour selection, 7-56 
Positioning and sizing, 7-54 
Shading, 7-56 
Specifying the data values, 7-54 
Pie symbolism, 6-80 
Exploded pies, 6-83 
Shading, 6-81 
PLOTTER, 3-11 
Plotting devices 
Selection, 3-11 
Point data input, 4-7 
Point in polygon searching, 8-16 
Point symbolism, 6-67 
Background symbolism, 6-72 
Continuous, 6-74 
Line types, 6-72 
Multi-component types, 6-70 
Scaling of multi-component symbols, 6-71 
Shading, 6-73 
Sizing, 6-69, 6-74 
Types, 6-69 
Point symbols, 6-95 
POINTS, 4-18, 4-22 
Polygon (area) and Segment data input, 4-6 
Polygon (area) data, 4-3 
Polygon checking, 5-1 
Polygon creation, 5-1 
Collapsed segments, 5-20 
Common errors, 5-17 
Compound errors, 5-21 
Concatenation of segments, 5-19 
Contents of diagnostic output, 5-15 
Diagnostic output, 5-10 
Diagnostic output level, 5-2, 5-5, 5-6 
Examples, 5-10 
File requirements, 5-1 
Generalisation of lines, 5-9 
Hierarchial subsets, 5-7 
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Inclusionlexclusion of zones, 5-6 

Interpreting the output, 5-14 

List of options, 5-2 

Maximum number of points, 5-5 

Mislabelling segments, 5-18 

Missing segments, 5-17 

Number of polygons, 5-1 

Number of zones, 5-4 

Ordering zones, 5-7 

Overshooting segments, 5-19 

Process of creation, 5-13 

Reduction of points, 5-5 

Selecting a group of zones, 5-7 

Size limitations, 5-12 

Space partitioning, 5-1 

Speed of processing, 5-1 

Using a mask on zone names, 5-8 
Polygon searching, 8-16 
POLYGONS, 4-18, 4-21 
Positioning the study area, 6-14 
Project design, 2-2 


Real number, 2-11 

Real vector value, 2-11 

Recycling GIMMS data, 9-12 

Restoring and saving DATA and GRID files, 9-26 
Run length encoding, 4-13 


Saving and restoring DATA and GRID files, 9-26 
Scaling plots, 6-11, 6-13 
Scattergrams, 7-1 
Sections 
1 Introduction, 1-0 
2 System operation, 2-0 
3 Main control program, 3-0 
4 Data input, 4-0 
5 Polygon creation, 5-0 
6 *PLOTPROG and *COMPILE, 6-0 
7 *GRAPHICS, 7-0 
8 *MANIPULATE, 8-0 
9 "UTILITIES, 9-0 
Appendices, A-0 
Segment editing, 5-21 
Adding a node, 5-38 
Adding a segment, 5-38 
Deleting segments, 5-36 
Drawing on screen, 5-32 
Excluding segments, 5-31, 5-32 
Extra segments, 5-29 
Forcing an update of editing, 5-38 
General guidelines, 5-27 
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Identifying nodes and segments, 5-26, 5-39 
Joining segments, 5-34 
Limitations, 5-40 
Linking zones, 5-39 
Missing segments, 5-29 
Quitting without changes, 5-30 
Removing segments, 5-36 
Renaming segments, 5-36 
Saving changes, 5-30 
Selecting segments, 5-24, 5-30 
Splitting segments, 5-36 
Starting up, 5-23 
The editing process, 5-22 
Zooming into picture, 5-32 
SEGMENTS, 4-21 
Selection of alphabets, 7-33, A-4 
Shading, 6-56 
Arrows, 6-100 
Bar, 6-58, 6-61, 6-66 
Colour, 6-60 
Continuous, 6-61, 6-66 
Contour, 6-85 
Crosshatch, 6-56, 6-63 
Diagnostic print, 6-62 
Dot screen, 6-58, 6-64, 6-76 
External, 6-58 
For graphs and bar graphs, 7-34, 7-40, 7-42, 7-44 
Halftone, 6-61, 6-65, 6-76 
North arrows, 6-98 
Pie symbolism, 6-81 
Pies, 7-56 
Point symbols, 6-73 
Setting all levels, 6-62 
Symbols, 6-65, 6-79 
Text, 3-17 
Types, 6-56 
Shading Types, 6-60 
Shielding rectangular areas, 6-89 
Smoothing GRID files, 8-28 
Examples, 8-31 
Limiting to study area, 8-29 
Method, 8-30 
Range of smoothing, 8-30 
Valid cells, 8-30 
Sorting DATA files, 8-6 
SPECIAL CHARACTERS, A-2 
SPECIFYING TEXT STRINGS, A-1 
String value, 2-11 
Sub - commands, 2-4 
Sub-commands, 2-4 
Subsetting data, 8-24 
Conditions, 8-26 
Examples, 8-27 
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Super Commands, 2-8 
Surface area, 5-1 
Symbolism, 6-56 
Area shading, 6-56 
Contour, 6-83 
Dot, 6-76 
Label, 6-75 
Pie, 6-80 
Point, 6-67 
Relating various types, 6-86 
Shading patterns, 6-56 
Symbols, 6-78 
System Commands, 3-3 
System Macro Library, 3-5 


Tektronix, 3-11 
Terminal 

Selection, 3-7 

Speed of communication, 3-14 
Terminal specification, 9-26 

Examples, 9-29 

Requirements, 9-26 

Specification of code sequences, 9-27 
Terminator, 2-8, 2-12 
Text, 6-26 

Accents, A-2 

Bolding, 3-16, 6-31 

Centring and justification, 6-33, A-6 

Character set, A-3 

Graphs and legends, 6-35 

Italics, 3-17, 6-32, A-5 

Keys for graphs, 7-33 

Labelling graphs, 7-30 

List of alphabets, B-1 

Pen selection, A-4 

Positioning, 6-28, 6-34 

Relative positioning, 6-30 

Selection of alphabets, 3-16, 6-30, A-4 

Setting defaults, 3-15 

Shading, 3-17, 6-37 

Shielding, 6-36 

Sizing, 6-28, A-4 

Special characters, A-2 

Specifying new alphabets, D-1 

Superscript and subscript, A-5 

Text to be plotted, 6-28, A-1 

Titles for graphs, 7-31 

Underlining, 3-17, 6-33, A-5 
Tolerance, 4-20 
Topological checking, 5-1 
Transformation of coordinates, 4-20 
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US National Bureau of Standards, B-1 
User defined routines, 4-14, 5-4 
User Macro Library, 3-5 


Windows, 6-89 
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